home *** CD-ROM | disk | FTP | other *** search
/ Chip 2003 January / Chip_2003-01_cd2.bin / articles / fotoalba / download / VCDEasy.exe / {app} / VCDImager / manual.txt < prev    next >
Encoding:
Text File  |  2002-01-04  |  113.8 KB  |  3,156 lines
  1. This file documents GNU VCDImager, The GNU Video CD Authoring Tools.
  2.  
  3.    Copyright (C) Herbert Valerio Riedel <<hvr@gnu.org>>
  4.  
  5.  
  6.  
  7.    Permission is granted to copy, distribute and/or modify this document
  8. under the terms of the GNU Free Documentation License, Version 1.1 or
  9. any later version published by the Free Software Foundation; with no
  10. Invariant Sections, one Front-Cover Text: "GNU VCDImager by Herbert
  11. Valerio Riedel et al." and one Back-Cover Text: "GNU VCDImager can be
  12. obtained at `http://www.gnu.org/software/vcdimager/'. The author is
  13. reachable at <hvr@gnu.org>".  A copy of the license is included in the
  14. section entitled "GNU Free Documentation License".
  15.  
  16. Table of Contents
  17. *****************
  18.  
  19.  
  20. Introduction
  21.   Supplied Tools
  22.   Features
  23.  
  24. Video CD Concepts
  25.   Overview
  26.   Anatomy of Video CD's
  27.   Known Video CD Flavors
  28.     Video CD 1.1
  29.     Video CD 2.0
  30.     Extended Video CD
  31.     Super Video CD 1.0
  32.     HQ Video CD 1.0
  33.     Extended Super Video CD
  34.   The ISO-9660 Track
  35.     Primary Volume Descriptor
  36.     Directory Structure
  37.       `/VCD' & `/SVCD' Directory
  38.       `/MPEGAV' & `/MPEG2' Directory
  39.       `/CDDA' Directory
  40.       `/SEGMENT' Directory
  41.       `/EXT' Directory
  42.       `/CDI' Directory
  43.   Constraints on MPEG streams
  44.     Video CD
  45.     Super Video CD
  46.       Scan Information Data
  47.       SVCD Subtitles
  48.     Common Constraints
  49.       Alignment
  50.       Access Point Sectors
  51.   Play Items
  52.     Sequence Items
  53.     Segment Items
  54.   Playback Control
  55.     Function Keys for Interaction
  56.     Linear Playback
  57.     PBC Lists
  58.       Play List
  59.       Selection List
  60.       End List
  61.       Command List
  62.     Applications
  63.  
  64. Reference
  65.   Tools
  66.     `vcdimager'
  67.     `vcddebug'
  68.     `vcdxgen'
  69.       Adding Files to the Video CD
  70.       CD-i Support
  71.     `vcdxbuild'
  72.     `vcdxrip'
  73.     `vcdxminfo'
  74.  
  75. Video CD XML Description
  76.   XML Simplified Rules
  77.   DTD Notation Reference
  78.   Video CD XML Conventions
  79.   `<videocd>' Root
  80.     `<option>' Element
  81.     `<info>' Container
  82.     `<pvd>' Container
  83.     `<filesystem>' Container
  84.       `<folder>' Element/Container
  85.       `<file>' Element
  86.     `<segment-items>' Container
  87.       `<segment-item>' Element
  88.     `<sequence-items>' Container
  89.       `<sequence-item>' Element
  90.     `<pbc>' Container
  91.       `<selection>' Element
  92.       `<playlist>' Element
  93.       `<endlist>' Element
  94.  
  95. Examples
  96.   Simple Multitrack Example
  97.   Video CD Disassembling
  98.  
  99. Tips and Hints
  100.   SVCD Player Compatibility
  101.   Fast Forward & Fast Rewind with Super Video CD's
  102.  
  103. Character Sets
  104.   ISO646 d-Characters
  105.   ISO646 a-Characters
  106.  
  107. Glossary
  108.  
  109. GNU General Public License
  110.   Preamble
  111.   Appendix: How to Apply These Terms to Your New Programs
  112.  
  113. GNU Free Documentation License
  114.   ADDENDUM: How to use this License for your documents
  115.  
  116. XML Tag Index
  117.  
  118. Concept Index
  119.  
  120.  
  121. Introduction
  122. ************
  123.  
  124.    This manual describes the "GNU VCDImager"(1) package, a tool-set for
  125. authoring, disassembling and analyzing Video CD's and Super Video CD's.
  126.  
  127.    ---------- Footnotes ----------
  128.  
  129.    (1) see `http://www.gnu.org/software/vcdimager/'
  130.  
  131. Supplied Tools
  132. ==============
  133.  
  134.    The following command-line tools are provided with this package:
  135.  
  136. `vcdimager'
  137.      Simple front-end, allowing for easy command-line controlled
  138.      generation of basic VCD and SVCD disc images without an
  139.      intermediate XML description.
  140.  
  141. `vcddebug'
  142.      Analyzing tool and report generator for VCD and SVCD discs.
  143.  
  144. `vcdxgen'
  145.      XML VCD-description generator, with a command-line interface
  146.      similar to the classic `vcdimager' front-end.
  147.  
  148. `vcdxbuild'
  149.      Builds a VCD/SVCD according to a supplied XML description and
  150.      files containing the MPEG program streams referred to in the XML
  151.      description.
  152.  
  153. `vcdxrip'
  154.      Disassembles a given VCD or SVCD disc into a XML description and
  155.      the contained MPEG program streams.
  156.  
  157. `vcdxminfo'
  158.      This is a debugging tool for displaying some MPEG properties, as
  159.      conceived by `libvcd'.
  160.  
  161. `cdxa2mpeg'
  162.      Simple tool for converting MPEG streams wrapped in RIFF CDXA
  163.      files, as created by some operating systems, to plain mpeg streams
  164.      suitable for vcdimager input.
  165.  
  166.    The generated CD-ROM images created are suitable for being burnt on
  167. to CD-R, by the use of a CD-recording program which recognizes the
  168. BIN/CUE-format, such as cdrdao(1), for instance.
  169.  
  170.    ---------- Footnotes ----------
  171.  
  172.    (1) see `http://www.ping.de/sites/daneb/cdrdao.html'
  173.  
  174. Features
  175. ========
  176.  
  177.    Features of the back-end library(1), on which all front-ends rely,
  178. include:
  179.  
  180.    * Support for Video CD 1.1 and 2.0 disc format.
  181.  
  182.    * Support for Super Video CD 1.0 and HQ Video CD 1.0(2) disc format.
  183.  
  184.    * Full PBC support, including fully customizable play lists, (multi
  185.      default) selection lists and end lists.
  186.  
  187.    * Support for segment (play) items (SPI).
  188.  
  189.    * Support for up to 98 sequence items (MPEG tracks) per (Super)
  190.      Video CD.
  191.  
  192.    * Support for additional entry points into sequence items.
  193.  
  194.    * Support for defining auto pause points in sequence items and
  195.      segment items.
  196.  
  197.    * General facility for adding files as mode 2 form 1 and mixed form
  198.      XA sectors to the ISO-9660 file-system and setting some labels in
  199.      the ISO-9660 PVD
  200.  
  201.    * Supports 99 minute CD-R media(3).
  202.  
  203.    * Image input support for GNU/Linux `ioctl()'-based cdrom devices,
  204.      BIN/CUE images and NRG images.
  205.  
  206.  
  207.    ---------- Footnotes ----------
  208.  
  209.    (1) the core of the GNU VCDImager package consists of a library
  210. named `libvcd', the front-ends are just user interfaces to the exported
  211. C-API
  212.  
  213.    (2) based on the IEC-62107 specification with some extensions
  214. defined in the super-set SVCD System Specification 1.0. Some support
  215. for the _deprecated_ Chinese SVCD format is available through option
  216. switches.
  217.  
  218.    (3) ...though most devices will have problems with such an
  219. out-of-specification media. You may want use the `--sector-2336' option
  220. for images longer than 80 minutes
  221.  
  222. Video CD Concepts
  223. *****************
  224.  
  225.    This chapter gives some background information regarding the
  226. underlying Video CD technology.
  227.  
  228.    *Warning:* All information in this chapter is presented without any
  229. warranty of accuracy or correctness. You are encouraged to send
  230. corrections and improvements for this manual to <bug-vcdimager@gnu.org>.
  231.  
  232. Overview
  233. ========
  234.  
  235.    The Video Compact Disc ("Video CD" or "VCD") is a standardized
  236. digital video storage format. It is based on the commonly available
  237. Compact Disc technology, which allows for low cost video authoring.
  238. Video CD's can be played in most DVD standalone player, dedicated VCD
  239. players and finally, modern Personal Computers with multimedia support.
  240.  
  241. Anatomy of Video CD's
  242. =====================
  243.  
  244.    Basically a Video CD is made up of CD-ROM XA sectors, i.e. CD-ROM
  245. mode 2 form 1 & 2 sectors. Non-MPEG data is stored in mode 2 form 1
  246. sectors with a user data area of 2048 byte, which have a similiar L2
  247. error correction and detection (ECC/EDC) to CD-ROM mode 1 sectors. While
  248. realtime MPEG streams is stored in CD-ROM mode 2 form 2 sectors, which
  249. by have no L2 ECC, yield a ~14% greater user data area consisting of
  250. 2324 bytes(1)
  251.  
  252.    *Warning:* Realtime MPEG streams on Video CD's are only protected by
  253. L2 error detection (but no correction!), EDC, and CIRC encoding. Thus
  254. Video CD's are more easily affected by scratches and alike on the
  255. CD-ROM media surface.
  256.  
  257.    In general, a Video CD is made up of several mode 2 (and optionally
  258. CD-DA) tracks. The layout of a Video CD is as follows:
  259.  
  260.    * lead-in area containing the TOC.
  261.  
  262.    * Mandatory pre-gap consisting of 150 sectors (`00:00:00' -
  263.      `00:01:74').
  264.  
  265.    * ISO-9660 data track. The beginning of this track is defined to
  266.      have the LSN `0'. *Note The ISO-9660 Track::.
  267.  
  268.         * ISO-9660 structure at `00:02:00' consisting of 16 empty
  269.           sectors, primary volume descriptor ("PVD") and directory
  270.           records with file pointers to information area structures
  271.           (described below) and external pointers to MPEG/CD-DA tracks
  272.           following the ISO-9660 data track.
  273.  
  274.         * Optional karaoke area at `00:03:00'. (not supported yet by
  275.           vcdimager)
  276.  
  277.         * Video CD information area at `00:04:00'.
  278.  
  279.         * Optional segment play item area with MPEG items aligned in 150
  280.           sector segments. There can be up to 1980 segments on a disc.
  281.  
  282.         * Optional program and data file area, for additional files
  283.           added to the ISO-9660 track.
  284.  
  285.  
  286.    * Up to 98 MPEG mode 2 form 2 tracks wrapped in front and rear
  287.      margin(2) empty sectors and preceded by (at least) 150 empty
  288.      sector pre-gaps.
  289.  
  290.    * 150 sector post-gap after the last mpeg track, as required by the
  291.      ECMA-130 standard.
  292.  
  293.    * Up to 97(3) CD-DA tracks. (not supported yet by vcdimager)
  294.  
  295.    * Lead-out area.
  296.  
  297.  
  298.    ---------- Footnotes ----------
  299.  
  300.    (1) actually raw mode 2 sectors have a 2336 byte user data area, but
  301. parts of it are used for error codes and headers when using the mode 2
  302. form 1 or form 2 configurations.
  303.  
  304.    (2) Margins seem to be used, in order to compensate for inaccurate
  305. sector addressing issues on CD-ROM media. Interestingly, they have been
  306. abandoned for the Super Video CD.
  307.  
  308.    (3) the maximum number of tracks on a Video CD must not exceed 99
  309. tracks
  310.  
  311. Known Video CD Flavors
  312. ======================
  313.  
  314.    There are different Video CD flavors commonly used. The following
  315. sections tries to explain the differences amongst them.
  316.  
  317. Video CD 1.1
  318. ------------
  319.  
  320.    This is the most basic Video CD specification dating back to
  321. 1993(1), which has the following characteristics:
  322.  
  323.    * One mode 2 mixed form ISO-9660 track containing file pointers to
  324.      the information areas.
  325.  
  326.    * Up to 98 multiplex-ed MPEG-1 audio/video streams or CD-DA audio
  327.      tracks.
  328.  
  329.    * Up to 500 MPEG sequence entry points used as chapter divisions.
  330.  
  331.  
  332.    The Video CD specification requires the multiplex-ed MPEG-1 stream
  333. to have a CBR of less than 174300 bytes (1394400 bits) per second(2) in
  334. order to accommodate single speed CD-ROM drives. The specification
  335. allows for the following two resolutions(3):
  336.  
  337.    * 352 x 240 @ 29.97 Hz (NTSC SIF).
  338.  
  339.    * 352 x 240 @ 23.976 Hz (FILM SIF).
  340.  
  341.    The CBR MPEG-1, layer II audio stream is fixed at 224 kbps with 1
  342. stereo or 2 mono channels.  It is recommended to keep the video
  343. bit-rate under 1151929.1 bps(4).
  344.  
  345.    ---------- Footnotes ----------
  346.  
  347.    (1) actually this flavor was based on the Karaoke-CD, which was the
  348. first MPEG based CD-ROM format.
  349.  
  350.    (2) 2324 bytes of payload per sector * 75 sectors per second =
  351. 174300 bytes per second
  352.  
  353.    (3) Actually even PAL resolution works depending on the playing
  354. device
  355.  
  356.    (4) It should be noted, that in addition to the audio stream and the
  357. video stream, there are also bits consumed by the program stream
  358. encapsulation which have to be taken into account for bit-rate
  359. calculations
  360.  
  361. Video CD 2.0
  362. ------------
  363.  
  364.    About two years after the Video CD 1.1 specification came out, an
  365. improved Video CD 2.0 standard was published in 1995. This one added the
  366. following items to the features already available in the Video CD 1.1
  367. specification:
  368.  
  369.    * Support for MPEG segment play items ("SPI"), consisting of still
  370.      pictures, motion pictures and/or audio (only) streams was added.
  371.      *Note Segment Items::.
  372.  
  373.    * Support for interactive playback control ("PBC") was added.
  374.  
  375.    * Support for playing related access by providing a scan point index
  376.      file was added. (`/EXT/SCANDATA.DAT')
  377.  
  378.    * Support for closed captions.
  379.  
  380.    * Support for mixing NTSC and PAL content.
  381.  
  382.  
  383. By adding PAL support to the Video CD 1.1 specification, the following
  384. resolutions became available:
  385.    * 352 x 240 @ 29.97 Hz (NTSC SIF).
  386.  
  387.    * 352 x 240 @ 23.976 Hz (FILM SIF).
  388.  
  389.    * 352 x 288 @ 25 Hz (PAL SIF).
  390.  
  391.    For segment play items the following audio encodings became
  392. available:
  393.  
  394.    * Joint stereo, stereo or dual channel audio streams at 128, 192,
  395.      224 or 384 kbit/sec bit-rate.
  396.  
  397.    * Mono audio streams at 64, 96 or 192 kbit/sec bit-rate.
  398.  
  399.    Also the possibility to have audio only streams and still
  400. pictures(1) was provided. The bit-rate of multiplex-ed streams should
  401. be kept under(2) 174300 bytes/sec (except for single still picture
  402. items) in order to accommodate single speed drives.
  403.  
  404.    ---------- Footnotes ----------
  405.  
  406.    (1) in addition to the resolutions already defined for motion video,
  407. also high resolutions are available for still pictures, which are 704 x
  408. 480 (NTSC Full D-2) and 704 x 576 (PAL Full D-2)
  409.  
  410.    (2) Alas it seems, that for _strict_ Video CD 2.0 compliance, it's
  411. required to pad the stream exactly to 1x muxrate. The Super Video CD
  412. format does not have this flaw.
  413.  
  414. Extended Video CD
  415. -----------------
  416.  
  417.    Also known as "XVCD", this is not an official standard. It's
  418. actually just a name for VCD's which do not conform with the official
  419. standards in order to use the additional performance of the DVD
  420. decoders and thus achieve better image quality. Such an XVCD may be
  421. unsupported by many available stand-alone playing devices.
  422.  
  423. Super Video CD 1.0
  424. ------------------
  425.  
  426.    With the upcoming of the DVD-V media, a new VCD standard had to be
  427. published in order to be able to keep up with technology, so the Super
  428. Video CD specification was called into life 1999. In the midst of 2000
  429. a full subset of this Super Video CD specification was published as
  430. IEC-62107.
  431.  
  432.    As the most notable change over Video CD 2.0 is a switch from MPEG-1
  433. CBR to MPEG-2 VBR encoding for the video stream was performed. The
  434. following new features--building upon the Video CD 2.0
  435. specification--are:
  436.  
  437.    * Use of MPEG-2 encoding instead of MPEG-1 for the video stream.
  438.  
  439.    * Allowed VBR encoding of MPEG-1 audio stream.
  440.  
  441.    * Higher resolutions (see below) for video stream resolution.
  442.  
  443.    * Up to 4 overlay graphics and text ("OGT") sub-channels for user
  444.      switchable subtitle displaying(1) in addition to the already
  445.      existing closed caption facility.
  446.  
  447.    * Command lists for controlling the SVCD virtual machine.
  448.  
  449.  
  450. For the Super Video CD, only the following two resolutions are supported
  451. for motion video and (low resolution) still pictures(2):
  452.  
  453.    * 480 x 480 @ 29.97 Hz (NTSC 2/3 D-2).
  454.  
  455.    * 480 x 576 @ 25 Hz (PAL 2/3 D-2).
  456.  
  457.    ---------- Footnotes ----------
  458.  
  459.    (1) There is also a non-compliant subtitle format widely used,
  460. having its origins in the forgotten "CVD" specification, which is said
  461. to have been a competitor for the Video CD 2.0 successor. Vcdimager
  462. recognizes both formats.
  463.  
  464.    (2) the same high resolutions as defined for Video CD 2.0 apply for
  465. Super Video CD's
  466.  
  467. HQ Video CD 1.0
  468. ---------------
  469.  
  470.    This is actually just a minor variation defined in IEC-62107 on the
  471. Super Video CD 1.0 format for _compatibility with current products in
  472. the market_. It differs from the Super Video CD 1.0 format in the
  473. following items:
  474.  
  475.    * The system profile tag field in `/SVCD/INFO.SVD' is set to `1'
  476.      instead of `0'.
  477.  
  478.    * The system identification field value in `/SVCD/INFO.SVD' is set to
  479.      `HQ-VCD' instead of `SUPERVCD'.
  480.  
  481.    * `/EXT/SCANDATA.DAT' is mandatory instead of being optional.
  482.  
  483.    * `/SVCD/SEARCH.DAT' is optional instead of being mandatory.
  484.  
  485.  
  486. Extended Super Video CD
  487. -----------------------
  488.  
  489.    Just like the XVCD, and thus also known as "XSVCD", this is not an
  490. official standard and may not work with all playing devices supporting
  491. SVCD's.
  492.  
  493. The ISO-9660 Track
  494. ==================
  495.  
  496. Primary Volume Descriptor
  497. -------------------------
  498.  
  499.    This ISO-9660 sector located at sector LSN 16 contains general
  500. information about the ISO-9660 file-system, such as volume label,
  501. various IDs, file-system size, pointer to the root directory and so
  502. on...
  503.  
  504. Directory Structure
  505. -------------------
  506.  
  507. `/VCD' & `/SVCD' Directory
  508. ..........................
  509.  
  510.    This directories (`/SVCD' is used on Super Video CD's) contain file
  511. entries to structures contained in the information area of a (Super)
  512. Video CD.
  513.  
  514. `/VCD/INFO.VCD'
  515.      General video disc information (e.g. album id, size of volume set
  516.      and number of MPEG items)
  517.  
  518. `/VCD/ENTRIES.VCD'
  519.      Entry point table.
  520.  
  521. `/VCD/LOT.VCD'
  522.      List ID Offset table into `PSD.VCD' (only allowed for Video CD 2.0
  523.      discs with PBC)
  524.  
  525. `/VCD/PSD.VCD'
  526.      Play sequence descriptor file (only allowed for Video CD 2.0 discs
  527.      with PBC). This file may contain so-called lists (selection lists,
  528.      play lists and end lists) which represent the PBC.
  529.  
  530. `/SVCD/INFO.SVD'
  531. `/SVCD/ENTRIES.SVD'
  532. `/SVCD/LOT.SVD'
  533. `/SVCD/PSD.SVD'
  534.      These are the corresponding file names on Super Video CD's, and
  535.      fulfill the same purpose as those defined for the Video CD 2.0
  536.      format.
  537.  
  538. `/SVCD/SEARCH.DAT'
  539.      This file, mandatory for Super Video CD's, contains access point
  540.      sector addresses. *Note Access Point Sectors::.
  541.  
  542. `/SVCD/TRACKS.SVD'
  543.      In this file additional information (e.g. playing time and stream
  544.      characteristics) about each sequence track is recorded.
  545.  
  546. `/MPEGAV' & `/MPEG2' Directory
  547. ..............................
  548.  
  549.    This file contains file entries pointing to the sequence items
  550. contained in the tracks after the ISO-9660 track.
  551.  
  552. `/CDDA' Directory
  553. .................
  554.  
  555.    This file contains file entries pointing to optional CDDA tracks
  556. after the ISO-9660 track. This feature is not available for Super Video
  557. CD's.
  558.  
  559. `/SEGMENT' Directory
  560. ....................
  561.  
  562.    This directory contains file entries to segment play items. *Note
  563. Segment Items::.
  564.  
  565. `/EXT' Directory
  566. ................
  567.  
  568. `/EXT/LOT_X.VCD'
  569. `/EXT/PSD_X.VCD'
  570.      These are only defined for Video CD 2.0, and contain the extended
  571.      PBC, which adds area definitions for pointer based selection
  572.      and/or highlighting of selection areas. (On Super Video CD's the
  573.      extended PBC has been merged into the main `/SVCD/PSD.SVD' file)
  574.  
  575. `/EXT/SCANDATA.DAT'
  576.      This file is optional, and defined (but with a different format)
  577.      for Video CD 2.0 and Super Video CD 1.0 formats. It contains
  578.      playing time related access information very similar to the
  579.      `/SVCD/SEARCH.DAT' file.
  580.  
  581. `/EXT/CAPTnn.DAT'
  582.      Closed caption data file entries.
  583.  
  584. `/CDI' Directory
  585. ................
  586.  
  587.    This directory is provided for CD-i player applications. (Only
  588. useful for Video CD's)
  589.  
  590. Constraints on MPEG streams
  591. ===========================
  592.  
  593.    GNU VCDImager expects MPEG streams in a format suitable for (Super)
  594. Video CD production. Only a few cases where the MPEG streams fail to
  595. adhere to this requirement are detected, thus it's up to the user to
  596. ensure that the constraints are fulfilled. All MPEG streams are
  597. expected to be packetized program streams.
  598.  
  599. Video CD
  600. --------
  601.  
  602.    The Video CD specification requires the multiplex-ed MPEG-1 stream
  603. to have a bit rate of about 174300 bytes per second. The video stream
  604. is required to have one of the following resolutions:
  605.  
  606.    * 352 x 240 @ 29.97 Hz (NTSC).
  607.  
  608.    * 352 x 240 @ 23.976 Hz (FILM).
  609.  
  610.    * 352 x 288 @ 25 Hz (PAL) (not supported on VCD 1.x!).
  611.  
  612.    The audio stream must be MPEG-1 layer II, fixed to a 224 kbits/sec
  613. CBR with 1 joint stereo, stereo or dual channel audio stream, and a
  614. sampling rate of 44.1 kHz at 16 bit resolution.
  615.  
  616. Super Video CD
  617. --------------
  618.  
  619.    When creating Super Video CD images MPEG-2 VBR streams are expected
  620. with a maximum allowed bit-rate of approximately 2.6 mbits/sec.  The
  621. following video resolutions are (officially) supported(1):
  622.  
  623.    * 480 x 480 @ 29.97 Hz (NTSC).
  624.  
  625.    * 480 x 576 @ 25 Hz (PAL).
  626.  
  627.    The audio stream must be MPEG-1 layer II, with a bit-rate ranging
  628. from 32 to 384 kbits/sec bit-rate (i.e. the audio stream _is_ allowed
  629. to be VBR!) with up to 2 stereo or 4 mono channels, or 1 extended
  630. MPEG-1/2 multichannel (5+1) surround sound stream.
  631.  
  632.    ---------- Footnotes ----------
  633.  
  634.    (1) actually you can try other resolutions as well, but then you are
  635. leaving the SVCD specification behind you...
  636.  
  637. Scan Information Data
  638. .....................
  639.  
  640.    According to the specification, it is mandatory for Super Video
  641. CD's(1) to encode scan information data into user data blocks in the
  642. picture layer of all intra coded picture. It can be used by playing
  643. devices for implementing fast forward & fast reverse scanning.
  644.  
  645.    The already existing scan information data can be updated by enabling
  646. the `update scan offsets' option. *Note <option> Element::.
  647.  
  648.    ---------- Footnotes ----------
  649.  
  650.    (1) It seems to be optionally supported for the Video CD 2.0
  651.  
  652. SVCD Subtitles
  653. ..............
  654.  
  655.    There exist two major subtitle formats for SVCD's, of which only one
  656. is officially supported. The non-compliant one has it's origin in the
  657. so-called CVD format, a competitor for the Video CD 2.0 successor. The
  658. _real_ SVCD subtitle format is part of the Super Video Specification,
  659. wheras the CVD-style subtitle format is not. Alas the latter one is
  660. more widely used, due to older pre-SVCD aged software only supporting
  661. the non-compliant CVD subtitle format.
  662.  
  663.    Compliant SVCD subtitles are transported in a `private_stream_1'
  664. stream with only the `private_data_id' `0x70'(1). The `sub_stream_id'
  665. is used to distinguish between the 4 available subtitle channels.
  666.  
  667.    As of the time of writing, there is only a proof of concept
  668. implementation (read _hack_) for creating proper SVCD subtitles. The
  669. source code is available from the contribs download directory, but its
  670. use is not recommended for production use. If you are searching for a
  671. new free software project, you could take this as an idea...
  672.  
  673.    ---------- Footnotes ----------
  674.  
  675.    (1) While AC3 tracks use the `private_data_id' `0x80+', DVD
  676. subtitles `0x20' onwards and CVD subtitles `0x00' and up.
  677.  
  678. Common Constraints
  679. ------------------
  680.  
  681. Alignment
  682. .........
  683.  
  684.    The MPEG program streams should be aligned to 2324 byte MPEG packet
  685. boundaries(1). If the pack headers should happen not be aligned on 2324
  686. byte boundaries, GNU VCDImager will try(2) to align them on the fly
  687. while issuing a warning that padding was needed. *Warning:* Padding the
  688. MPEG streams causes the bit-rate at which the data is read to be
  689. increased, this may lead to undesirable effects.
  690.  
  691.    If the image generation process should abort with an MPEG related
  692. error message, it maybe either due to a bug or due to a corrupted or
  693. non-compliant MPEG stream coding. In this case re-encoding or
  694. re-multiplexing may help.
  695.  
  696.    ---------- Footnotes ----------
  697.  
  698.    (1) i.e. pack headers must be repeated every 2324 bytes, starting on
  699. byte 0
  700.  
  701.    (2) aligning only works, if MPEG packets are _not_ bigger than 2324
  702. bytes.
  703.  
  704. Access Point Sectors
  705. ....................
  706.  
  707.    An "Access Point Sector", APS, is an MPEG video sector on the
  708. VCD/SVCD which is suitable to be jumped to directly. APS are required
  709. for entry points and scantables.
  710.  
  711.    APS have to fulfill the requirement to precede every I-frame by a
  712. GOP header which shall be preceded by a sequence header in its turn.
  713. The start codes of these 3 items are required to be contained all in
  714. the same mpeg pack/sector, thus forming a so-called "access point
  715. sector".
  716.  
  717.    This requirement can be relaxed by enabling the `relaxed aps'
  718. option, i.e. every sector containing an I-frame will be regarded as an
  719. APS. *Warning:* The sequence header is needed for a playing device to
  720. figure out display parameters, such as display resolution and frame
  721. rate, relaxing the aps requirement may lead to non-working entry points.
  722.  
  723. Play Items
  724. ==========
  725.  
  726.    "Play items" are the MPEG payload on (Super) Video CD's. Sequences
  727. are useful for seamless play of larger video sections, whereas segments
  728. are better for smaller items in interactive applications.
  729.  
  730. Sequence Items
  731. --------------
  732.  
  733.    Each "sequence" is put in its own CD track. Motion video stream is
  734. required, with optionally up to 2 audio streams.
  735.  
  736. Advantages
  737. ..........
  738.  
  739.    * Can be directly accessed without requiring PBC.
  740.  
  741.    * Entry points.
  742.  
  743.  
  744. Disadvantages
  745. .............
  746.  
  747.    * Pre-gap of 150 empty sectors.
  748.  
  749.    * Limit of 98 sequences.
  750.  
  751.    * Must contain motion video (and audio for Video CD 2.0).
  752.  
  753.  
  754. Segment Items
  755. -------------
  756.  
  757.    Segment items are stored in the so-called SPI area, which consists
  758. of up to 1980 allocation units which are called "segments". Each
  759. segment consists of 150 XA form 2 sectors.  Thus the SPI area can
  760. contain up to 658 MB of real-time data(1).
  761.  
  762.    A segment (play) item is a MPEG stream stored in one or more
  763. consecutive segments. A segment item can be
  764.    * MPEG video with _optional_ MPEG audio.
  765.  
  766.    * MPEG encoded still pictures with _optional_ MPEG audio.
  767.  
  768.    * MPEG audio only.(2)
  769.  
  770. Advantages
  771. ..........
  772.  
  773.    * Up to 1980 segment items possible.
  774.  
  775.    * Still pictures and audio only MPEG streams allowed.
  776.  
  777.    * No pre-gaps.
  778.  
  779.  
  780. Disadvantages
  781. .............
  782.  
  783.    * Only PBC accessible through PBC.
  784.  
  785.    * Segment item size limited by SPI area size.
  786.  
  787.  
  788.    ---------- Footnotes ----------
  789.  
  790.    (1) 1980 * 150 * 2324 = 690228000 bytes
  791.  
  792.    (2) Which allows for several hours of audio only play back to fit on
  793. a CD-ROM.
  794.  
  795. Playback Control
  796. ================
  797.  
  798.    "Playback control", PBC, is available for Video CD 2.0 and Super
  799. Video CD 1.0 disc formats. PBC allows control of the playback of play
  800. items(1) and the possibility of interaction with the user through the
  801. remote control or some other input device available.
  802.  
  803.    ---------- Footnotes ----------
  804.  
  805.    (1) sequence items and segment items
  806.  
  807. Function Keys for Interaction
  808. -----------------------------
  809.  
  810.    The following keys are usually found on the remote control belonging
  811. to the playing device.
  812.  
  813. <NEXT>
  814.      May also look like <>>|> on the remote control.
  815.  
  816. <PREVIOUS>
  817.      May also look like <|<<> on the remote control.
  818.  
  819. <DEFAULT>
  820.      This key is usually mapped to the <>> or <PLAY> key.
  821.  
  822. <RETURN>
  823.      This key may be mapped to the <STOP> key.
  824.  
  825. <NUMERIC>
  826.      This is actually a pseudo key, representing the numeric keys <0>,
  827.      <1>, ..., <9>.
  828.  
  829. Linear Playback
  830. ---------------
  831.  
  832.    This playback mode is active, when the PSD is not interpreted. In
  833. this mode, the <NUMERIC> key causes to start playback at the entry in
  834. `ENTRY.VCD'/`ENTRY.SVD' with the index number pressed. The <NEXT> and
  835. <PREVIOUS> keys play the next or previous entry in that the entry file.
  836. This mode allows for compliant playing devices to honor the entry
  837. points defined as chapter division markers(1). Alas, only a few playing
  838. devices are capable of honoring Video CD chapters.
  839.  
  840.    ---------- Footnotes ----------
  841.  
  842.    (1) in fact even when the play item is contained in a play-list it
  843. should allow to jump between the entry points with the
  844. <NEXT>/<PREVIOUS> keys.
  845.  
  846. PBC Lists
  847. ---------
  848.  
  849.    The control structures involved in PBC are called "lists" and are
  850. stored in the "play sequence descriptor" file.
  851.  
  852. Play List
  853. .........
  854.  
  855.    A "Play list" is basically a collection of play items which are to
  856. be played in the order specified. Play lists allow to define target
  857. lists for the <NEXT>, <PREVIOUS> and <RETURN> keys on the remote
  858. control.
  859.  
  860. Selection List
  861. ..............
  862.  
  863.    "Selection lists" are used to offer a user selection based on
  864. numeric (<NUMERIC>) input or--if available--pointer device based
  865. selection, while showing a play item.
  866.  
  867.    Also features such as random selection, default target (<DEFAULT>),
  868. timeout target and looping are supported.
  869.  
  870. Hot-spots
  871. .........
  872.  
  873.    The Video CD format allows for so-called hot-spots in selection
  874. lists, which are used to define areas on the screen for selection
  875. targets, which can be used for pointer device based selection in
  876. addition to the <NUMERIC> input, and/or for highlighting of areas on
  877. the screen on selection.
  878.  
  879.    Alas, this very useful feature is not widely supported amongst
  880. playing devices.
  881.  
  882. Multi Default Selection List
  883. ............................
  884.  
  885.    "Multi default selection lists" are a special variant of selection
  886. lists which allow for defining different <DEFAULT> key targets,
  887. depending on which section of the play item the playback is currently
  888. in. The various sections are defined by using entry points which mark
  889. the boundaries.
  890.  
  891. End List
  892. ........
  893.  
  894.    An "end list" can be used to terminate the interpretation of the PBC
  895. information.
  896.  
  897. Command List
  898. ............
  899.  
  900.    "Command lists" are an optional feature defined for Super Video CD's,
  901. allowing to execute opcodes in a virtual machine, allowing for enhanced
  902. interactivity.
  903.  
  904. Applications
  905. ------------
  906.  
  907.    _...to be written..._
  908.  
  909. Reference
  910. *********
  911.  
  912. Tools
  913. =====
  914.  
  915. `vcdimager'
  916. -----------
  917.  
  918.    This is the classic front-end, which is maintained only for ease of
  919. use and because it does not relay on `libxml2' and thus may be the only
  920. built front-end. `vcdimager' does not create a dummy PBC anymore as in
  921. the past. It is recommended to familiarize with the XML front-ends, in
  922. order to be able to use the extended features offered by GNU VCDImager.
  923.  
  924.    There are a few command-line options for `vcdimager' at the moment,
  925. please issue `vcdimager --help' for an actual list of available options.
  926.  
  927. `vcddebug'
  928. ----------
  929.  
  930.    While this project went along, `vcddebug' was used to analyze and
  931. reverse engineer existing Video CD's and later Super Video CD's. It has
  932. grown into a valuable debugging tool and report generator for (Super)
  933. Video CD's.
  934.  
  935.    It is recommended to make use of this tool if compatibility problems
  936. arise, to identify what the difference between working discs and
  937. non-working discs are, and thus help to improve GNU VCDImager.
  938.  
  939. `vcdxgen'
  940. ---------
  941.  
  942.    This tool works almost like the `vcdimager' tool, except that it
  943. creates an intermediate XML description, instead of directly building
  944. the disc image. This XML can be used as a starting point for
  945. customization.
  946.  
  947.    The XML file can then be fed to `vcdxbuild' for building the actual
  948. image file(s).
  949.  
  950.    _FIXME: write more_
  951.  
  952. Adding Files to the Video CD
  953. ............................
  954.  
  955.    Files can be added to the ISO file-system, that is the first track
  956. of the Video CD, by making use of the command-line options
  957. `--add-file=FILE,ISO_FILENAME' and `--add-file-2336=FILE,ISO_FILENAME'.
  958. The latter option allows you to include files containing the complete
  959. user data of mode 2 CD-ROM sectors (1).
  960.  
  961.    The path name given as ISO_FILENAME determines where to link the
  962. file in the file-system of the Video CD. The given path name must be a
  963. valid ISO-9660 file name with the following restrictions:
  964.    * The Character set is restricted to upper case letters, numbers,
  965.      underscore `_', dot `.' and slash `/', *Note ISO646 d-Characters::.
  966.  
  967.    * The maximum file name length is restricted to 31 characters, the
  968.      directory nesting level is restricted to 8 and the maximum path
  969.      length is limited to 255 characters.
  970.  
  971.    * File names must contain exactly one dot.(2)
  972.  
  973.    * ISO-9660 conformance level 1 restrictions apply, i.e. file names
  974.      are restricted to 8.3 characters.
  975.  
  976.    * The path-name must not begin or end with a slash nor should it
  977.      contain slashes following directly each other.
  978.  
  979.  
  980.    If the parent directory for a file entry does not exist it will be
  981. created automatically on demand.
  982.  
  983.    ---------- Footnotes ----------
  984.  
  985.    (1) 8 bytes for sub-header, 2324 bytes payload (which contains 276
  986. bytes ECC for form 1) and finally 4 bytes for EDC
  987.  
  988.    (2) if no file name extension is supposed to exist the dot must be
  989. placed as a trailing dot.
  990.  
  991. CD-i Support
  992. ............
  993.  
  994.    There is no specific CD-i support in GNU VCDImager. But you can use
  995. the general facilities for adding a custom CD-i player application.
  996.  
  997.    If you happen to have a CD-i application consisting of the files
  998. `cdi_imag.rtf', `cdi_text.fnt', `cdi_vcd.app' and `cdi_vcd.cfg', with
  999. `cdi_vcd.app' being the main application executable, you could add the
  1000. following lines to your `~/.popt' popt(1) aliasing file(2)
  1001.  
  1002.      vcdimager alias --cdi \
  1003.          --iso-application-id "CDI/CDI_VCD.APP;1" \
  1004.          --add-file-2336 /usr/share/cdi/cdi_imag.rtf,CDI/CDI_IMAG.RTF \
  1005.          --add-file      /usr/share/cdi/cdi_text.fnt,CDI/CDI_TEXT.FNT \
  1006.          --add-file      /usr/share/cdi/cdi_vcd.app,CDI/CDI_VCD.APP \
  1007.          --add-file      /usr/share/cdi/cdi_vcd.cfg,CDI/CDI_VCD.CFG
  1008.  
  1009.    ---------- Footnotes ----------
  1010.  
  1011.    (1) see documentation for popt for more information about option
  1012. aliasing
  1013.  
  1014.    (2) add it to `/etc/popt' if the setting should be available
  1015. system-wide
  1016.  
  1017. `vcdxbuild'
  1018. -----------
  1019.  
  1020.    This program allows to actually build a disc image, based on a given
  1021. XML description and the files referenced therein. It can be thought of
  1022. a Video CD _compiler_ for XML descriptions of Video CD's.
  1023.  
  1024.    _FIXME: write more_
  1025.  
  1026. `vcdxrip'
  1027. ---------
  1028.  
  1029.    This tool implements the inverse operation to `vcdxbuild', i.e.,
  1030. taking an already built disc image and outputting all the file items and
  1031. the XML description necessary to recreate this (Super) Video CD
  1032. including any PBC information.
  1033.  
  1034. `--output-file'
  1035. `-o'
  1036.      This option allows to specify the xml file name for output.
  1037.      default: `videocd.xml'.
  1038.  
  1039. `--norip'
  1040.      By the use of this option, only the XML description is created,
  1041.      without actually extracting any files or mpeg streams contained.
  1042.  
  1043.    _FIXME: write more_
  1044.  
  1045. `vcdxminfo'
  1046. -----------
  1047.  
  1048.    This tool allows to show basic properties of MPEG streams as seen by
  1049. the back-end library. Dumping of all APS contained in the stream is
  1050. supported as well.
  1051.  
  1052.    _FIXME: write more_
  1053.  
  1054. Video CD XML Description
  1055. ************************
  1056.  
  1057.    The DTD the XML description conforms to, can be downloaded from
  1058. `http://www.gnu.org/software/vcdimager/videocd.dtd'.
  1059.  
  1060.    This chapter is merely a reference. Pointers to examples and more
  1061. practical information about the XML structure used in vcdimager are
  1062. available at `http://www.vcdimager.org/'.
  1063.  
  1064.    The use of `vcdxgen' is recommended as a starting point point, when
  1065. creating an advanced XML description.(1)
  1066.  
  1067.    ---------- Footnotes ----------
  1068.  
  1069.    (1) Graphical user interfaces to aid XML editing are in development,
  1070. if you want to join the GUI development group, please get into contact
  1071. with me at <<hvr@gnu.org>>.
  1072.  
  1073. XML Simplified Rules
  1074. ====================
  1075.  
  1076.    * All attribute values must be quoted.
  1077.  
  1078.    * White space within content, including line breaks, is significant.
  1079.  
  1080.    * All start tags (`<pbc>') must have corresponding end tags
  1081.      (`</pbc>').
  1082.  
  1083.    * Tags without content and those which are empty elements must use
  1084.      the `/>'-notation, e.g.: `<next-volume-use-lid2 />'.
  1085.  
  1086.    * Elements must not overlap; they may be nested, however.
  1087.  
  1088.    * Element names are case sensitive: `<videocd>' and `<VideoCD>' are
  1089.      two different entities.
  1090.  
  1091. DTD Notation Reference
  1092. ======================
  1093.  
  1094.    Each section of the description of the Video CD XML format begins
  1095. with a fragment from the Video CD DTD. The following table gives a
  1096. simplified (and incomplete) reference for the notational syntax.
  1097.  
  1098. `#PCDATA'
  1099.      parsed character data, i.e. only text without sub-elements allowed
  1100.  
  1101. `EMPTY'
  1102.      empty, i.e. no sub-element allowed
  1103.  
  1104. `()'
  1105.      grouping
  1106.  
  1107. `A?'
  1108.      A or nothing (A is optional, but at most one A)
  1109.  
  1110. `A+'
  1111.      one or more A's (at least one)
  1112.  
  1113. `A*'
  1114.      zero or more A's (A optional, but could be several A's)
  1115.  
  1116. `(A | B | C)'
  1117.      either A or B or C (but only one)
  1118.  
  1119. `(A, B, C)'
  1120.      first A, followed by B, then C (all, and in this order)
  1121.  
  1122. `(A & B)'
  1123.      both A and B, in any order
  1124.  
  1125. Video CD XML Conventions
  1126. ========================
  1127.  
  1128. Time Values
  1129. -----------
  1130.  
  1131.    All time related values--`<wait>', `<autowait>', `<playtime>',
  1132. `<start-time-offset>', `<entry>' and `<auto-pause>'--are given in
  1133. seconds.
  1134.  
  1135.    For the `<wait>' and `<autowait>' time entries the values given are
  1136. rounded to values of the following set:
  1137.  
  1138. `-1'
  1139.      meaning an _infinite_ wait time. Negative values get rounded to
  1140.      `-1'.
  1141.  
  1142. `0'
  1143.      meaning no wait time.
  1144.  
  1145. `1'
  1146.      ranging from `1' to `60' in steps of 1, representing the time to
  1147.      wait in whole seconds.
  1148.  
  1149. `60'
  1150.      ranging from `60' to `2000' in steps of 10, representing the time
  1151.      to wait in whole seconds.
  1152.  
  1153. `2000'
  1154.      maximum wait time of 2000 seconds (33 minutes 20 seconds). Values
  1155.      larger will be truncated to this maximum wait time.
  1156.  
  1157.    For `<loop>' and `<playtime>' the value `0' means _repeat forever_
  1158. and _play until end_ accordingly.
  1159.  
  1160. Item IDs
  1161. --------
  1162.  
  1163.    Items and their associated IDs fall into two categories, _play
  1164. items_ and _PSD items_. Every reference to an ID has to be of the right
  1165. class, otherwise the reference can't be resolved, due to a failing look
  1166. up. A _play item_ can be any of the following:
  1167.  
  1168.    * play nothing item, (omitted `ref' attribute, e.g.: `<play-item
  1169.      />').
  1170.  
  1171.    * sequence item, `<sequence-item>'.
  1172.  
  1173.    * entry point into sequence item, `<entry>'.
  1174.  
  1175.    * segment item segment play item, `<segment-item>'.
  1176.  
  1177. Whereas a _PSD item_ is required to be one of:
  1178.  
  1179.    * disabled, (omitted `ref' attribute, e.g.: `<select />').
  1180.  
  1181.    * selection list, `<selection>'.
  1182.  
  1183.    * play list, `<playlist>'.
  1184.  
  1185.    * end list, `<endlist>'.
  1186.  
  1187. `<videocd>' Root
  1188. ================
  1189.  
  1190.      <!ELEMENT videocd                       (option*,
  1191.                                               info,
  1192.                                               pvd,
  1193.                                               filesystem?,
  1194.                                               segment-items?,
  1195.                                               sequence-items,
  1196.                                               pbc?)>
  1197.      <!ATTLIST videocd
  1198.        class        CDATA  #REQUIRED
  1199.        version      CDATA  #REQUIRED
  1200.        xmlns        %URI;  #FIXED 'http://www.gnu.org/software/vcdimager/1.0/'
  1201.      >
  1202.      
  1203.      <!ENTITY % URI "CDATA">
  1204.  
  1205. `class'
  1206. `version'
  1207.      Supported combinations of CLASS and VERSION are listed below:
  1208.      CLASS   VERSION Description
  1209.      `vcd'   `1.0'   Video CD 1.0/Karaoke CD _experimental_
  1210.      `vcd'   `1.1'   Video CD 1.1
  1211.      `vcd'   `2.0'   Video CD 2.0
  1212.      `svcd'  `1.0'   Super Video CD 1.0 (IEC-62107)
  1213.      `hqvcd' `1.0'   HQ Video CD 1.0 (IEC-62107)
  1214.  
  1215. `xmlns'
  1216.      The `xmlns' attribute defines the XML name-space.
  1217.  
  1218.      <?xml version="1.0"?>
  1219.      <!DOCTYPE videocd PUBLIC "-//GNU//DTD VideoCD//EN"
  1220.                "http://www.gnu.org/software/vcdimager/videocd.dtd">
  1221.      <videocd xmlns="http://www.gnu.org/software/vcdimager/1.0/"
  1222.               class="svcd" version="1.0">
  1223.      ...
  1224.      </videocd>
  1225.  
  1226. `<option>' Element
  1227. ------------------
  1228.  
  1229.      <!ELEMENT option                        EMPTY>
  1230.      <!ATTLIST option
  1231.        name         CDATA  #REQUIRED
  1232.        value        CDATA  #IMPLIED
  1233.      >
  1234.  
  1235.    The following option NAME are recognized.
  1236.  
  1237. `svcd vcd30 mpegav'
  1238.      Rename `/MPEG2' folder on SVCDs to (non-compliant) `/MPEGAV'.
  1239.  
  1240.      Allowed `value' content: `true', `false'. Default: `false'.
  1241.  
  1242. `svcd vcd30 entrysvd'
  1243.      Enables the use of the (deprecated) signature `ENTRYSVD' instead of
  1244.      `ENTRYVCD' for the file `/SVCD/ENTRY.SVD'.
  1245.  
  1246.      Allowed `value' content: `true', `false'. Default: `false'.
  1247.  
  1248. `svcd vcd30 tracksvd'
  1249.      Enables the use of the (deprecated) chinese `/SVCD/TRACKS.SVD'
  1250.      format which differs from the format defined in the IEC-62107
  1251.      specification. The differences are most exposed on SVCDs
  1252.      containing more than one video track.
  1253.  
  1254.      Allowed `value' content: `true', `false'. Default: `false'.
  1255.  
  1256. `track pregap'
  1257.      Used to set the track pre-gap for all tracks(1) in sectors
  1258.      globally. The specification requires the pre-gaps to be at least
  1259.      150 sectors long.
  1260.  
  1261.      Allowed `value' content: [`1'..`300']. Default: `150'.
  1262.  
  1263. `track front margin'
  1264.      Set's the front margin for sequence items. For Video CD
  1265.      1.0/1.1/2.0 this margin should be at least 15 sectors long.
  1266.  
  1267.      Allowed `value' content: [`0'..`150']. Default: `30' for Video CD
  1268.      1.0/1.1/2.0, otherwise (i.e. Super Video CD 1.0 and HQ-VCD 1.0)
  1269.      `0'.
  1270.  
  1271. `track rear margin'
  1272.      Set's the rear margin for sequence items. For Video CD 1.0/1.1/2.0
  1273.      this margin should be at least 15 sectors long.
  1274.  
  1275.      Allowed `value' content: [`0'..`150']. Default: `45' for Video CD
  1276.      1.0/1.1/2.0, otherwise `0'.
  1277.  
  1278. `leadout pregap'
  1279.      This option(2)  allows to set the amount of empty sectors added
  1280.      before the lead-out area begins, i.e. the amount of post-gap
  1281.      sectors. The ECMA-130 specification requires the last data track
  1282.      before the lead-out to carry a post-gap of at least 150 sectors,
  1283.      which is used as default for this parameter.
  1284.  
  1285.      Some operating systems may encounter I/O errors due to read-ahead
  1286.      issues when reading the last mpeg track if this parameter is set
  1287.      to low.
  1288.  
  1289.      Allowed `value' content: [`0'..`300']. Default: `150'.
  1290.  
  1291. `leadout pause'
  1292.      _DEPRECATED_. Use `leadout pregap' instead. This option is
  1293.      equivalent to setting the `leadout pregap' option to the (default)
  1294.      value `150'.
  1295.  
  1296.      Allowed `value' content: `true', `false'. Default: `true'.
  1297.  
  1298. `relaxed aps'
  1299.      This controls whether APS constraints are strict or relaxed. *Note
  1300.      Access Point Sectors::.
  1301.  
  1302.      Allowed `value' content: `true', `false'. Default: `false'.
  1303.  
  1304. `update scan offsets'
  1305.      This controls whether to update the scan data information
  1306.      contained in the MPEG-2 video streams(3). *Note Scan Information
  1307.      Data::.
  1308.  
  1309.      Allowed `value' content: `true', `false'. Default: `false'.
  1310.  
  1311.      ...
  1312.      <videocd xmlns=...
  1313.        <option name="relaxed aps" value="true"/>
  1314.        <info>
  1315.      ...
  1316.  
  1317.    ---------- Footnotes ----------
  1318.  
  1319.    (1) except for the first one, which is hardwired to 150 sectors
  1320.  
  1321.    (2) Should have been better named `data track post-gap'.
  1322.  
  1323.    (3) It is required, that the stream has already user data groups
  1324. with scan information data, in order for this feature to work
  1325.  
  1326. `<info>' Container
  1327. ------------------
  1328.  
  1329.      <!ELEMENT info                          (album-id?,
  1330.                                               volume-count?,
  1331.                                               volume-number?,
  1332.                                               next-volume-use-sequence2?,
  1333.                                               next-volume-use-lid2?,
  1334.                                               restriction?,
  1335.                                               start-time-offset*)>
  1336.      
  1337.      <!ELEMENT album-id                      (#PCDATA)>
  1338.      <!ELEMENT volume-count                  (#PCDATA)>
  1339.      <!ELEMENT volume-number                 (#PCDATA)>
  1340.      <!ELEMENT next-volume-use-sequence2     EMPTY>
  1341.      <!ELEMENT next-volume-use-lid2          EMPTY>
  1342.      <!ELEMENT restriction                   (#PCDATA)>
  1343.      <!ELEMENT start-time-offset             (#PCDATA)>
  1344.  
  1345.    The `<info>' section allows to customize the information contained
  1346. in the `VCD/INFO.VCD' or `VCD/INFO.SVD'.
  1347.  
  1348. `<album-id>'
  1349.      Name of the album(1) which the discs belongs to. This id is used
  1350.      in conjunction with the following elements to decide whether a
  1351.      disc is the next volume of the currently played one.
  1352.  
  1353.      The Content restricted to upto 16 d-characters, *Note ISO646
  1354.      d-Characters::.
  1355.  
  1356. `<volume-count>'
  1357.      Total number of volumes (discs) in the album identified by
  1358.      `<album-id>'.
  1359.  
  1360.      Allowed content: [`1'..`65535']. Default: `1'.
  1361.  
  1362. `<volume-number>'
  1363.      Ordinal number of the volume (disc) in the album.
  1364.  
  1365.      Allowed content: [`0'..`65535']. Default: `1'.
  1366.  
  1367. The following elements are only supported for Video CD 2.0, Super Video
  1368. CD 1.0 and HQ Video CD 1.0.
  1369.  
  1370. `<next-volume-use-sequence2/>'
  1371.      If PBC interpretation is disabled, start the next disc if it has
  1372.      the same `<album-id>' at the second sequence instead of the first.
  1373.  
  1374. `<next-volume-use-lid2/>'
  1375.      If PBC is present and interpretation enabled, start the next disc
  1376.      if it has the same `<album-id>' at the second PBC list instead of
  1377.      the first one.
  1378.  
  1379. `<restriction>'
  1380.      Restriction category. This element allows to set viewing
  1381.      restrictions which may be interpreted by the playing device. The
  1382.      allowed range goes from `0', i.e. unrestricted, to `3', i.e.
  1383.      restriction category 3.(2)
  1384.  
  1385. `<start-time-offset>'
  1386.      Only supported for Super Video CD 1.0 and HQ Video CD 1.0. Up to 5
  1387.      `<start-time-offset>' may be defined, which represent the start
  1388.      time offsets for the first 5 discs of an album. _not implemented
  1389.      yet_
  1390.  
  1391.      ...
  1392.        <info>
  1393.          <album-id>GNU_WARS_EP9</album-id>
  1394.          <volume-count>2</volume-count>
  1395.          <volume-number>1</volume-number>
  1396.          <next-volume-use-sequence2/>
  1397.        </info>
  1398.      ...
  1399.  
  1400.    ---------- Footnotes ----------
  1401.  
  1402.    (1) An _album_ is defined as a series of discs which contain related
  1403. content
  1404.  
  1405.    (2) The exact meaning of the restriction categories is depending on
  1406. the interpreting playing device.
  1407.  
  1408. `<pvd>' Container
  1409. -----------------
  1410.  
  1411.      <!ELEMENT pvd                           (volume-id?,
  1412.                                               system-id?,
  1413.                                               application-id?,
  1414.                                               preparer-id?,
  1415.                                               publisher-id?)>
  1416.      
  1417.      <!ELEMENT volume-id                     (#PCDATA)>
  1418.      <!ELEMENT system-id                     (#PCDATA)>
  1419.      <!ELEMENT application-id                (#PCDATA)>
  1420.      <!ELEMENT preparer-id                   (#PCDATA)>
  1421.      <!ELEMENT publisher-id                  (#PCDATA)>
  1422.  
  1423.    This part of the XML structure describes the primary volume
  1424. descriptor of the disc.
  1425.  
  1426. `<volume-id>'
  1427.      Volume label of the CD-ROM. Content restricted to upto 32
  1428.      d-characters, *Note ISO646 d-Characters::. This is label usually
  1429.      shows up on computer systems as volume label.
  1430.  
  1431. `<system-id>'
  1432.      System id of the CD-ROM. Content restricted to up to 32
  1433.      a-characters. Should be set to `CD-RTOS CD-BRIDGE' for Video CD's
  1434.      for CD-i compatibility.  This fields content is ignored by
  1435.      vcdimager and always set to `CD-RTOS CD-BRIDGE'.
  1436.  
  1437. `<application-id>'
  1438.      Defines the application pathname for CD-i playing devices.
  1439.  
  1440. `<preparer-id>'
  1441.      This field is used by vcdimager to put a version string on the
  1442.      Video CD, regardless of the content given in the XML description
  1443.      which is ignored.
  1444.  
  1445. `<publisher-id>'
  1446.      Data Preparer Identifier for the CD-ROM. Content restricted to up
  1447.      to 128 a-characters*Note ISO646 a-Characters::.
  1448.  
  1449.      ...
  1450.        <pvd>
  1451.          <volume-id>GNU_WARS_EP9_1_OF_2</volume-id>
  1452.          <system-id>CD-RTOS CD-BRIDGE</system-id>
  1453.          <publisher-id>John Doe</publisher-id>
  1454.        </pvd>
  1455.      ...
  1456.  
  1457. `<filesystem>' Container
  1458. ------------------------
  1459.  
  1460.      <!ELEMENT filesystem                    (folder*,
  1461.                                               file*)>
  1462.  
  1463.    This section of the XML description allows for the creation of
  1464. additional folders and files into the ISO-9660 filesystem on the Video
  1465. CD. *Note Adding Files to the Video CD::.
  1466.  
  1467. `<folder>' Element/Container
  1468. ............................
  1469.  
  1470.      <!ELEMENT folder                        (name,
  1471.                                               folder*,
  1472.                                               file*)>
  1473.      
  1474.      <!ELEMENT name                          (#PCDATA)>
  1475.  
  1476. `<name>'
  1477.      Directory name in the ISO-9660 domain.
  1478.  
  1479.      ...
  1480.        <filesystem>
  1481.          <folder>
  1482.            <name>CDI</name>
  1483.            <file src=...>
  1484.      ...
  1485.          </folder>
  1486.        </filesystem>
  1487.      ...
  1488.  
  1489. `<file>' Element
  1490. ................
  1491.  
  1492.      <!ELEMENT file                          (name)>
  1493.      <!ATTLIST file
  1494.        src          %URI;  #REQUIRED
  1495.        format       (form1|mixed) "form1"
  1496.      >
  1497.      <!ELEMENT name                          (#PCDATA)>
  1498.  
  1499. `<name>'
  1500.      Filename in the ISO-9660 domain.
  1501.  
  1502. `src'
  1503.      Source location of the file.
  1504.  
  1505. `format'
  1506.      Whether file is an ordinary `form1' file, or a `mixed' form
  1507.      real-time file containing the sector information in 2336 byte
  1508.      blocks.
  1509.  
  1510.      ...
  1511.          <folder>
  1512.            <name>CDI</name>
  1513.            <file src="/usr/share/cdi/cdi_imag.rtf" format="mixed">
  1514.              <name>CDI_IMAG.RTF</name>
  1515.            </file>
  1516.            <file src="/usr/share/cdi/cdi_text.fnt">
  1517.              <name>CDI_TEXT.FNT</name>
  1518.            </file>
  1519.      ...
  1520.  
  1521. `<segment-items>' Container
  1522. ---------------------------
  1523.  
  1524.      <!ELEMENT segment-items                 (segment-item)+>
  1525.  
  1526.    Only supported for Video CD 2.0, Super Video CD 1.0 and HQ Video CD
  1527. 1.0.
  1528.  
  1529. `<segment-item>' Element
  1530. ........................
  1531.  
  1532.      <!ELEMENT segment-item                  (auto-pause)*>
  1533.      <!ATTLIST segment-item
  1534.        id           ID     #REQUIRED
  1535.        src          %URI;  #REQUIRED
  1536.      >
  1537.      
  1538.      <!ELEMENT auto-pause                    (#PCDATA)>
  1539.  
  1540. `<segment-item>'
  1541.      Element representing a segment item. Segment play items need to be
  1542.      referenced from the `<pbc>' section in order to be accessible at
  1543.      all.
  1544.  
  1545. `id'
  1546.      Id string to be referenced in `ref' attributes.
  1547.  
  1548. `src'
  1549.      This attribute specifies the external file name of the item, i.e.
  1550.      the location of the file containing the MPEG stream to be included.
  1551.  
  1552. `<auto-pause>'
  1553.      See description in `<sequence-item>'.
  1554.  
  1555.      ...
  1556.        <segment-items>
  1557.      ...
  1558.          <segment-item src="stills/splash.mpg" id="seg-still-splash" />
  1559.      
  1560.          <segment-item src="animations/intro.mpg" id="seg-animation-intro" />
  1561.      
  1562.          <segment-item src="animations/intra.mpg" id="seg-animation-intra" />
  1563.      
  1564.          <segment-item src="animations/extro.mpg" id="seg-animation-extro" />
  1565.      ...
  1566.        <segment-items>
  1567.      ...
  1568.  
  1569. `<sequence-items>' Container
  1570. ----------------------------
  1571.  
  1572.      <!ELEMENT sequence-items                (sequence-item)+>
  1573.  
  1574. `<sequence-item>' Element
  1575. .........................
  1576.  
  1577.      <!ELEMENT sequence-item                 (default-entry?,
  1578.                                               entry*,
  1579.                                               auto-pause*)>
  1580.      <!ATTLIST sequence-item
  1581.        id           ID     #IMPLIED
  1582.        src          %URI;  #REQUIRED
  1583.      >
  1584.      
  1585.      <!ELEMENT auto-pause                    (#PCDATA)>
  1586.      
  1587.      <!ELEMENT default-entry EMPTY>
  1588.      <!ATTLIST default-entry
  1589.        id           ID     #REQUIRED
  1590.      >
  1591.      
  1592.      <!ELEMENT entry                         (#PCDATA)>
  1593.      <!ATTLIST entry
  1594.        id           ID     #IMPLIED
  1595.      >
  1596.  
  1597. `<sequence-item>'
  1598.      Element representing a sequence item. Each sequence item
  1599.      corresponds to a single track in the resulting disc.
  1600.  
  1601. `id'
  1602.      ID value referenced in `ref' attributes.
  1603.  
  1604. `src'
  1605.      This attribute specifies the external file name of the item, i.e.
  1606.      MPEG stream, to be included.
  1607.  
  1608. `<auto-pause>'
  1609.      This element specifies where to insert auto pause points, whose
  1610.      wait time is controlled by play lists' `<autowait>'. The time is
  1611.      given in seconds from the beginning of the sequence.
  1612.  
  1613. `<default-entry>'
  1614.      Represents the mandatory default entry point pointing to the start
  1615.      of the sequence(1).
  1616.  
  1617. `<entry>'
  1618.      Defines an additional entry point into the sequence item. Up to 99
  1619.      entry points (including the default entry point) can be defined
  1620.      per sequence, while only a maximum of 500 entry points(2) can be
  1621.      present in the whole disc. The entry point time is given in
  1622.      seconds from the beginning of the sequence.  If referenced from
  1623.      PBC the sequence which contains the entry point is played from the
  1624.      entry point to the end of the sequence (_not_ to the next entry
  1625.      point!). *Note Access Point Sectors::.
  1626.  
  1627. `id'
  1628.      Play item ID value referenced in `ref' attributes.
  1629.  
  1630.      ...
  1631.        <sequence-items>
  1632.      ...
  1633.          <sequence-item src="videos/movie.mpg" id="seq-movie">
  1634.            <default-entry id="ent-movie-0" />
  1635.            <entry id="ent-movie-1">90.32</entry>
  1636.            <entry id="ent-movie-2">710</entry>
  1637.            <entry id="ent-movie-3">1760.5</entry>
  1638.            <entry id="ent-movie-4">3050</entry>
  1639.          </sequence-item>
  1640.      
  1641.          <sequence-item src="videos/trailer1.mpg" id="seq-trailer-1" />
  1642.      
  1643.          <sequence-item src="videos/trailer2.mpg" id="seq-trailer-2">
  1644.            <auto-pause>15.300</auto-pause>
  1645.            <auto-pause>260.7</auto-pause>
  1646.          </sequence-item>
  1647.      ...
  1648.        <sequence-items>
  1649.      ...
  1650.  
  1651.    ---------- Footnotes ----------
  1652.  
  1653.    (1) Referencing the default entry point id should be equivalent to
  1654. referencing the sequence id. Depending on the firmware of the playing
  1655. device, the sequence id may reflect the start of the sequence as
  1656. defined by the TOC, while the default entry id gets defined by the
  1657. address defined in the `ENTRY.VCD' or `ENTRY.SVD'
  1658.  
  1659.    (2) every sequence point has automatically an entry point defined,
  1660. which must be subtracted from the maximum of 500 entry points
  1661.  
  1662. `<pbc>' Container
  1663. -----------------
  1664.  
  1665.      <!ELEMENT pbc                           (selection|
  1666.                                               playlist|
  1667.                                               endlist)+>
  1668.      
  1669.      <!ENTITY % pbcattrs
  1670.      " id           ID     #REQUIRED
  1671.        rejected     (true|false) 'false'"
  1672.      >
  1673.      
  1674.      <!ENTITY % XY "CDATA">
  1675.      
  1676.      <!ENTITY % ofsattrs
  1677.      " ref          IDREF  #REQUIRED
  1678.        x1           %XY;   #IMPLIED
  1679.        y1           %XY;   #IMPLIED
  1680.        x2           %XY;   #IMPLIED
  1681.        y2           %XY;   #IMPLIED"
  1682.      >
  1683.      
  1684.      <!ELEMENT play-item                      EMPTY>
  1685.      <!ATTLIST play-item
  1686.        ref          IDREF  #IMPLIED
  1687.      >
  1688.  
  1689.    `<pbc>' container and sub-elements only supported for Video CD 2.0,
  1690. Super Video CD 1.0 and HQ Video CD 1.0.
  1691.  
  1692. `id'
  1693.      ID value referenced in `ref' attributes.
  1694.  
  1695. `rejected'
  1696.      Attribute controlling, whether item is not listed, i.e. _rejected_,
  1697.      in the LOT. Lists which are not rejected may be--if supported by
  1698.      the playing device--select-able by user input of the automatically
  1699.      assigned _List ID Number_. It is recommended to enable the rejected
  1700.      property for but the very first PBC list, in order to make the
  1701.      _unreferenced item check_ work better.  The first PBC Item must not
  1702.      be rejected.
  1703.  
  1704. `x1 y1 x2 y2'
  1705.      Screen Co-ordinates for selection hotspot areas (only supported for
  1706.      `<selection>' members), with `0,0' being the upper left and
  1707.      `255,255' being the lower right screen point. `x1' and `y1' are
  1708.      required to be less than `x2' and `y2' respectively. *Note
  1709.      Selection List::.
  1710.  
  1711. `play-item'
  1712.      This empty element is used to reference play item ids. If the `ref'
  1713.      attribute is ommitted (e.g. `<play-item />', the _play nothing
  1714.      item_ is implicitly referenced.
  1715.  
  1716. `<selection>' Element
  1717. .....................
  1718.  
  1719.      <!ELEMENT selection                     (bsn?,
  1720.                                               prev?,
  1721.                                               next?,
  1722.                                               return?,
  1723.                                               (multi-default|default)?,
  1724.                                               timeout?,
  1725.                                               wait?,
  1726.                                               loop?,
  1727.                                               play-item?,
  1728.                                               select*)>
  1729.      <!ATTLIST selection
  1730.        %pbcattrs;
  1731.      >
  1732.      
  1733.      <!ELEMENT      bsn                      (#PCDATA)>
  1734.      <!ELEMENT      prev                     EMPTY>
  1735.      <!ELEMENT      next                     EMPTY>
  1736.      <!ELEMENT      return                   EMPTY>
  1737.      
  1738.      <!ELEMENT      default                  EMPTY>
  1739.      <!ELEMENT      multi-default            EMPTY>
  1740.      <!ATTLIST multi-default
  1741.        numeric      (enabled|disabled)  'enabled'
  1742.      >
  1743.      
  1744.      <!ELEMENT      timeout                  EMPTY>
  1745.      <!ELEMENT      wait                     (#PCDATA)>
  1746.      
  1747.      <!ELEMENT      loop                     (#PCDATA)>
  1748.      <!ATTLIST loop
  1749.        jump-timing  (immediate|delayed) 'immediate'
  1750.      >
  1751.      
  1752.      <!ELEMENT      play-item                EMPTY>
  1753.      <!ELEMENT      select                   EMPTY>
  1754.  
  1755. `<bsn>'
  1756.      Base selection number, the numeric value which is taken as the
  1757.      first selection number. The default is `1' and the allowed range
  1758.      goes from 1 upto 99.
  1759.  
  1760. `<prev>'
  1761.      Target list id jumped to on <PREVIOUS> key press.
  1762.  
  1763. `<next>'
  1764.      Target list id jumped to on <NEXT> key press.
  1765.  
  1766. `<return>'
  1767.      Target list id jumped to on <RETURN> key press.
  1768.  
  1769. `<default>'
  1770.      Target list id jumped to on <DEFAULT> key press. May not be present
  1771.      at the same time with the following element.
  1772.  
  1773.      If a `<default>' target is defined, `<loop>' should not be set to
  1774.      loop forever (`0') nor shall `<wait>' indicate an infinite
  1775.      time-out wait time, otherwise the target will be unreachable.
  1776.  
  1777. `<multi-default>'
  1778.      When present, causes the selection list to be a multi default
  1779.      selection list, i.e. that the target list id of the <DEFAULT>
  1780.      depends on which part of the sequence item is playing. The
  1781.      `numeric' attributes, if _disabled_, allows to disable the
  1782.      <NUMERIC> keys. When using multi default selections, the `<bsn>'
  1783.      must be set to 1 and the number of selection must match the number
  1784.      of all entry points of the sequence referenced by `<play-item>'.
  1785.  
  1786. `<timeout>'
  1787.      Target list id to be jumped on time-out of `<wait>'. If omitted
  1788.      (and `<wait>' is not set to an infinite time) one of the
  1789.      `<select>' targets is selected at random!
  1790.  
  1791. `<wait>'
  1792.      Time in seconds to wait after playback of `<play-item>' before
  1793.      triggering the `<timeout>' action (unless the user triggers some
  1794.      action before time ran up). Default: `0'.
  1795.  
  1796. `<loop>'
  1797.      Times to repeat the playback of `<play-item>'. the `jump-timing'
  1798.      attribute controls whether the playback of `<play-item>' is
  1799.      finished, thus _delayed_, before executing user triggered action
  1800.      or an _immediate_ jump is performed. After the specified amount of
  1801.      repetitions are completed, the `<wait>' time begins to count down,
  1802.      unless set to an infinite wait time by setting it to the value
  1803.      `0'. If this element is omitted, a default of `1' is used, i.e.
  1804.      the `<play-item>' will be displayed once. The default for the
  1805.      `jump-timing' is IMMEDIATE.
  1806.  
  1807.      When the `jump-timing' is set to _delayed_, it is recommended that
  1808.      the length of the referenced `<play-item>' is not more than 5
  1809.      seconds. The recommended setting for a play item consisting of one
  1810.      still picture and no audio is to loop once and have a _delayed_
  1811.      `jump-timing'.
  1812.  
  1813. `<play-item>'
  1814.      The _play item_ to be played while waiting for user intervention.
  1815.  
  1816. `<select>'
  1817.      Target list id(s) jumped to on <NUMERIC> key presses. There may be
  1818.      up to 99 select choices. The sum of `<bsn>' and the number of
  1819.      `<select>' elements per `<selection>' must not be greater than 100.
  1820.  
  1821. `<playlist>' Element
  1822. ....................
  1823.  
  1824.      <!ELEMENT playlist                      (prev?,
  1825.                                               next?,
  1826.                                               return?,
  1827.                                               playtime?,
  1828.                                               wait?,
  1829.                                               autowait?,
  1830.                                               play-item+)>
  1831.      <!ATTLIST playlist
  1832.        %pbcattrs;
  1833.      >
  1834.      
  1835.      <!ELEMENT      prev                     EMPTY>
  1836.      <!ELEMENT      next                     EMPTY>
  1837.      <!ELEMENT      return                   EMPTY>
  1838.      <!ELEMENT      playtime                 (#PCDATA)>
  1839.      <!ELEMENT      wait                     (#PCDATA)>
  1840.      <!ELEMENT      autowait                 (#PCDATA)>
  1841.      <!ELEMENT      play-item                EMPTY>
  1842.  
  1843. `<prev>'
  1844.      Target list id jumped to on <PREVIOUS> key press.
  1845.  
  1846. `<next>'
  1847.      Target list id jumped to on <NEXT> key press.
  1848.  
  1849. `<return>'
  1850.      Target list id jumped to on <RETURN> key press.
  1851.  
  1852. `<playtime>'
  1853.      The amount of seconds to play of every `<play-item>'. The given
  1854.      time value is rounded to 1/15 second units. The allowed range has a
  1855.      maximum value of `4369.0' seconds, values equal or less than `0'
  1856.      cause each `<play-item>' to be played to its end.  Default: `0'
  1857.  
  1858. `<wait>'
  1859.      Time in seconds to wait after each playback of `<play-item>' before
  1860.      proceding. Default: `0'.
  1861.  
  1862. `<autowait>'
  1863.      Time in seconds to wait at each defined `<auto-pause>' point for
  1864.      sequence items referenced in this play list. Default: `0'.
  1865.  
  1866. `<play-item>'
  1867.      The _play item(s)_ to play in order. Up to 255 `<play-item>'
  1868.      elements may be defined per `<playlist>'.
  1869.  
  1870.      ...
  1871.        <pbc>
  1872.      ...
  1873.          <playlist id="play-trailers">
  1874.            <prev ref="select-specialfeaturemenu"/>
  1875.            <next ref="select-specialfeaturemenu"/>
  1876.            <return ref="select-specialfeaturemenu"/>
  1877.            <wait>0</wait>
  1878.            <autowait>0</autowait>
  1879.            <play-item ref="seg-animation-intro"/>
  1880.            <play-item ref="seq-trailer-1"/>
  1881.            <play-item ref="seg-animation-intra"/>
  1882.            <play-item ref="seq-trailer-2"/>
  1883.            <play-item ref="seg-animation-intra"/>
  1884.            <play-item ref="seq-trailer-3"/>
  1885.            <play-item ref="seg-animation-extro"/>
  1886.          </playlist>
  1887.      ...
  1888.        </pbc>
  1889.      </videocd>
  1890.      ...
  1891.  
  1892. `<endlist>' Element
  1893. ...................
  1894.  
  1895.      <!ELEMENT endlist                       (next-volume?,
  1896.                                               play-item?)>
  1897.      <!ATTLIST endlist
  1898.        %pbcattrs;
  1899.      >
  1900.      
  1901.      <!ELEMENT next-volume                   (#PCDATA)>
  1902.  
  1903. The following elements are only supported for Super Video CD 1.0 and HQ
  1904. Video CD 1.0.
  1905.  
  1906. `<next-volume>'
  1907.      Only supported for Super Video CD's. If set to _0_ stop PBC
  1908.      intepretation, otherwise switch to the selected volume number.
  1909.  
  1910. `<play-item>'
  1911.      Only supported for Super Video CD's. Displays the referenced image
  1912.      while waiting for a volume change. Referenced play item shall be a
  1913.      still picture.
  1914.  
  1915.      ...
  1916.          <endlist id="end-lid">
  1917.            <next-volume>2</next-volume>
  1918.            <play-item ref="change-disc-segitem"/>
  1919.          </endlist>
  1920.      ...
  1921.        </pbc>
  1922.      </videocd>
  1923.      ...
  1924.  
  1925. Examples
  1926. ********
  1927.  
  1928.    The general procedure for creating a (Super) Video CD involves the
  1929. following steps:
  1930.  
  1931.   1. Get an idea for a Video CD.
  1932.  
  1933.   2. Collecting, creating or encoding the required MPEG items for
  1934.      inclusion on the Video CD.
  1935.  
  1936.   3. Design some sophisticated PBC flow and create a XML description
  1937.      reflecting that or use `vcdxgen' to generate a very simple Video
  1938.      CD structure.
  1939.  
  1940.   4. Let `vcdxbuild' process the XML description created in the
  1941.      previous step. If required fix warnings and errors displayed by
  1942.      `vcdxbuild'.
  1943.  
  1944.   5. Write the created disc image to a CD-R.
  1945.  
  1946.  
  1947.    The steps of encoding compliant MPEG program streams are not covered
  1948. in this manual.(1)
  1949.  
  1950.    The last step, writing to a CD-R, can be accomplished by `cdrdao'(2)
  1951. as simple as:
  1952.  
  1953.      $ cdrdao write --device 0,5,0 --speed 8 videocd.cue
  1954.      Cdrdao version 1.1.5 - (C) Andreas Mueller <andreas@daneb.de>
  1955.        SCSI interface library - (C) Joerg Schilling
  1956.        L-EC encoding library - (C) Heiko Eissfeldt
  1957.        Paranoia DAE library - (C) Monty
  1958.      
  1959.      Check http://cdrdao.sourceforge.net/drives.html#dt for current driver
  1960.      tables.
  1961.      
  1962.      Using libscg version 'schily-0.5'
  1963.      
  1964.      0,5,0: YAMAHA CRW8424S    Rev: 1.0j
  1965.      Using driver: Generic SCSI-3/MMC - Version 1.2 (options 0x0000)
  1966.      
  1967.      Starting write at speed 8...
  1968.      Pausing 10 seconds - hit CTRL-C to abort.
  1969.      Process can be aborted with QUIT signal (usually CTRL-\).
  1970.      Executing power calibration...
  1971.      Power calibration successful.
  1972.      Writing track 01 (mode MODE2_RAW/MODE2_RAW)...
  1973.      Writing track 02 (mode MODE2_RAW/MODE2_RAW)...
  1974.      Wrote 750 of 750 MB (Buffer 100%).
  1975.      Wrote 334544 blocks. Buffer fill min 96%/max 100%.
  1976.      Flushing cache...
  1977.      Writing finished successfully.
  1978.      $
  1979.  
  1980.    ---------- Footnotes ----------
  1981.  
  1982.    (1) see `http://mjpeg.sourceforge.net/'
  1983.  
  1984.    (2) see `http://cdrdao.sourceforge.net/'
  1985.  
  1986. Simple Multitrack Example
  1987. =========================
  1988.  
  1989.    In the following example session, the files `track1.mpg',
  1990. `track2.mpg' and `track3.mpg' are mastered into the default output
  1991. files `videocd.cue' and `videocd.bin'. The volume label is set to `My
  1992. Test VCD'.
  1993.  
  1994.      $ vcdimager --iso-volume-label="MY_TEST_VCD" track1.mpg track2 track3.mpg
  1995.         INFO: scanning mpeg sequence item #0 for scanpoints...
  1996.         INFO: scanning mpeg sequence item #1 for scanpoints...
  1997.         INFO: scanning mpeg sequence item #2 for scanpoints...
  1998.         INFO: writing track 1 (ISO-9660)...
  1999.         INFO: writing track 2, MPEG1, NTSC (352x240/30fps), 1 audio stream...
  2000.         INFO: writing track 3, MPEG1, PAL (352x288/25fps), 1 audio stream...
  2001.         INFO: writing track 4, MPEG1, NTSC (352x240/30fps), 1 audio stream...
  2002.      finished ok, image created with 13626 sectors [03:01.51]
  2003.      $
  2004.  
  2005.    The same with XML based tools:
  2006.  
  2007.      $ vcdxgen --iso-volume-label="MY_TEST_VCD" track1.mpg track2 track3.mpg
  2008.      (Super) VideoCD xml description created successfully as `videocd.xml'
  2009.      $ vcdxbuild videocd.xml
  2010.         INFO: scanning mpeg sequence item #0 for scanpoints...
  2011.         INFO: scanning mpeg sequence item #1 for scanpoints...
  2012.         INFO: scanning mpeg sequence item #2 for scanpoints...
  2013.         INFO: writing track 1 (ISO-9660)...
  2014.         INFO: writing track 2, MPEG1, NTSC (352x240/30fps), 1 audio stream...
  2015.         INFO: writing track 3, MPEG1, PAL (352x288/25fps), 1 audio stream...
  2016.         INFO: writing track 4, MPEG1, NTSC (352x240/30fps), 1 audio stream...
  2017.      finished ok, image created with 13626 sectors [03:01.51]
  2018.      $
  2019.  
  2020. Video CD Disassembling
  2021. ======================
  2022.  
  2023.    The next example show how to extract the PBC information and the
  2024. MPEG streams contained in the image file `videocd.bin' (the resulting
  2025. streams are stored in files named `avseq##.mpg' with `##' being the
  2026. track number, starting with 0).
  2027.  
  2028.      $ vcdxrip -b videocd.bin
  2029.         INFO: detected extended VCD2.0 PBC files
  2030.         INFO: extracting avseq00.mpg... (start lsn 450 (+4739))
  2031.         INFO: extracting avseq01.mpg... (start lsn 5189 (+4160))
  2032.         INFO: extracting avseq02.mpg... (start lsn 9349 (+4277))
  2033.         INFO: writing xml description to `videocd.xml'...
  2034.         INFO: done
  2035.      $
  2036.  
  2037. Tips and Hints
  2038. **************
  2039.  
  2040. SVCD Player Compatibility
  2041. =========================
  2042.  
  2043.    If you have problems with your playing device failing to _detect_ a
  2044. created SVCD, you can may the following things (some of the advices
  2045. below apply to VCDs as well):
  2046.  
  2047.   1. Take warnings serious! If there were warnings issued during the
  2048.      image building process, chances are the problems are related to
  2049.      them.
  2050.  
  2051.   2. Make sure the SVCD is physically OK (e.g., analyze the disc with
  2052.      `vcddebug' or try it on some other playing device).
  2053.  
  2054.   3. Try creating the SVCD by enabling the `svcd vcd30 mpegav' and
  2055.      `svcd vcd30 entrysvd' options.
  2056.  
  2057.   4. Add an empty `/SEGMENT' directory, if it isn't created due to
  2058.      inclusion of SPIs.
  2059.  
  2060.   5. If you have confusing time readings for discs with more than one
  2061.      video track, you might need to use the `svcd vcd30 tracksvd'
  2062.      option.
  2063.  
  2064.  
  2065. Fast Forward & Fast Rewind with Super Video CD's
  2066. ================================================
  2067.  
  2068.    Because of the VBR encoding of the MPEG-2 streams on SVCDs, there's
  2069. no fixed relation between sector index and playing time. If scanning
  2070. doesn't work with your playing device it can be caused by:
  2071.  
  2072.    * The playing device does not support FF/RW with SVCDs.(1)
  2073.  
  2074.    * The MPEG-2 streams playing time longer that can be handled by the
  2075.      playing device.(2)
  2076.  
  2077.    * The MPEG-2 stream does not include the mandatory scan information
  2078.      data or when included, it doesn't follow the specification(3).
  2079.      *Note Scan Information Data::.
  2080.  
  2081.    * Some playing devices require a sequence header before each GOP
  2082.      header. *Note Access Point Sectors::.
  2083.  
  2084.  
  2085.    ---------- Footnotes ----------
  2086.  
  2087.    (1) Sometimes upgrading the player firmware may help.
  2088.  
  2089.    (2) Some devices don't support programs with a playing time of over
  2090. about 40 minutes. This is to be seen as bug or limitation of the
  2091. firmware, as SVCD's can have programs with up to 100 minute playing
  2092. times.
  2093.  
  2094.    (3) `libvcd' warns if scan information is missing or syntactically
  2095. wrong.
  2096.  
  2097. Character Sets
  2098. **************
  2099.  
  2100. ISO646 d-Characters
  2101. ===================
  2102.  
  2103.        | 0 1 2 3 4 5 6 7
  2104.      --+-----------------
  2105.      0 |       0   P
  2106.      1 |       1 A Q
  2107.      2 |       2 B R
  2108.      3 |       3 C S
  2109.      4 |       4 D T
  2110.      5 |       5 E U
  2111.      6 |       6 F V
  2112.      7 |       7 G W
  2113.      8 |       8 H X
  2114.      9 |       9 I Y
  2115.      a |         J Z
  2116.      b |         K
  2117.      c |         L
  2118.      d |         M
  2119.      e |         N
  2120.      f |         O _
  2121.  
  2122. ISO646 a-Characters
  2123. ===================
  2124.  
  2125.        | 0 1 2 3 4 5 6 7
  2126.      --+-----------------
  2127.      0 |       0   P
  2128.      1 |     ! 1 A Q
  2129.      2 |     " 2 B R
  2130.      3 |       3 C S
  2131.      4 |       4 D T
  2132.      5 |     % 5 E U
  2133.      6 |     & 6 F V
  2134.      7 |     ' 7 G W
  2135.      8 |     ( 8 H X
  2136.      9 |     ) 9 I Y
  2137.      a |     * : J Z
  2138.      b |     + ; K
  2139.      c |     , < L
  2140.      d |     - = M
  2141.      e |     . > N
  2142.      f |     / ? O _
  2143.  
  2144. Glossary
  2145. ********
  2146.  
  2147. APS
  2148.      access point sector
  2149.  
  2150. CBR
  2151.      constant bit rate
  2152.  
  2153. CD
  2154.      compact disc
  2155.  
  2156. CD-DA
  2157.      CD digital audio
  2158.  
  2159. CD-ROM
  2160.      CD read only memory
  2161.  
  2162. DVD
  2163.      digital versatile disc
  2164.  
  2165. DVD-V
  2166.      DVD for video
  2167.  
  2168. DVD-A
  2169.      DVD for audio
  2170.  
  2171. FSF
  2172.      free software foundation, `http://www.fsf.org/'
  2173.  
  2174. GNU
  2175.      GNU is not UNIX, `http://www.gnu.org/'
  2176.  
  2177. MPEG
  2178.      movie picture experts group
  2179.  
  2180. OGT
  2181.      overlay graphics & text
  2182.  
  2183. PEM
  2184.      program end marker
  2185.  
  2186. PBC
  2187.      playback control
  2188.  
  2189. PSD
  2190.      play sequence descriptor
  2191.  
  2192. PVD
  2193.      primary volume descriptor
  2194.  
  2195. SVCD
  2196.      Super VCD
  2197.  
  2198. VBR
  2199.      variable bit rate
  2200.  
  2201. VCD
  2202.      Video CD
  2203.  
  2204. XML
  2205.      extensible markup language, `http://www.w3.org/XML/'
  2206.  
  2207. XSVCD
  2208.      eXtended SVCD
  2209.  
  2210. XVCD
  2211.      eXtended VCD
  2212.  
  2213. GNU General Public License
  2214. **************************
  2215.  
  2216.                          Version 2, June 1991
  2217.  
  2218.      Copyright (C) 1989, 1991 Free Software Foundation, Inc.
  2219.      59 Temple Place - Suite 330, Boston, MA  02111-1307, USA
  2220.      
  2221.      Everyone is permitted to copy and distribute verbatim copies
  2222.      of this license document, but changing it is not allowed.
  2223.  
  2224. Preamble
  2225. ========
  2226.  
  2227.    The licenses for most software are designed to take away your
  2228. freedom to share and change it.  By contrast, the GNU General Public
  2229. License is intended to guarantee your freedom to share and change free
  2230. software--to make sure the software is free for all its users.  This
  2231. General Public License applies to most of the Free Software
  2232. Foundation's software and to any other program whose authors commit to
  2233. using it.  (Some other Free Software Foundation software is covered by
  2234. the GNU Library General Public License instead.)  You can apply it to
  2235. your programs, too.
  2236.  
  2237.    When we speak of free software, we are referring to freedom, not
  2238. price.  Our General Public Licenses are designed to make sure that you
  2239. have the freedom to distribute copies of free software (and charge for
  2240. this service if you wish), that you receive source code or can get it
  2241. if you want it, that you can change the software or use pieces of it in
  2242. new free programs; and that you know you can do these things.
  2243.  
  2244.    To protect your rights, we need to make restrictions that forbid
  2245. anyone to deny you these rights or to ask you to surrender the rights.
  2246. These restrictions translate to certain responsibilities for you if you
  2247. distribute copies of the software, or if you modify it.
  2248.  
  2249.    For example, if you distribute copies of such a program, whether
  2250. gratis or for a fee, you must give the recipients all the rights that
  2251. you have.  You must make sure that they, too, receive or can get the
  2252. source code.  And you must show them these terms so they know their
  2253. rights.
  2254.  
  2255.    We protect your rights with two steps: (1) copyright the software,
  2256. and (2) offer you this license which gives you legal permission to copy,
  2257. distribute and/or modify the software.
  2258.  
  2259.    Also, for each author's protection and ours, we want to make certain
  2260. that everyone understands that there is no warranty for this free
  2261. software.  If the software is modified by someone else and passed on, we
  2262. want its recipients to know that what they have is not the original, so
  2263. that any problems introduced by others will not reflect on the original
  2264. authors' reputations.
  2265.  
  2266.    Finally, any free program is threatened constantly by software
  2267. patents.  We wish to avoid the danger that redistributors of a free
  2268. program will individually obtain patent licenses, in effect making the
  2269. program proprietary.  To prevent this, we have made it clear that any
  2270. patent must be licensed for everyone's free use or not licensed at all.
  2271.  
  2272.    The precise terms and conditions for copying, distribution and
  2273. modification follow.
  2274.  
  2275.     TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
  2276.  
  2277.   0. This License applies to any program or other work which contains a
  2278.      notice placed by the copyright holder saying it may be distributed
  2279.      under the terms of this General Public License.  The "Program",
  2280.      below, refers to any such program or work, and a "work based on
  2281.      the Program" means either the Program or any derivative work under
  2282.      copyright law: that is to say, a work containing the Program or a
  2283.      portion of it, either verbatim or with modifications and/or
  2284.      translated into another language.  (Hereinafter, translation is
  2285.      included without limitation in the term "modification".)  Each
  2286.      licensee is addressed as "you".
  2287.  
  2288.      Activities other than copying, distribution and modification are
  2289.      not covered by this License; they are outside its scope.  The act
  2290.      of running the Program is not restricted, and the output from the
  2291.      Program is covered only if its contents constitute a work based on
  2292.      the Program (independent of having been made by running the
  2293.      Program).  Whether that is true depends on what the Program does.
  2294.  
  2295.   1. You may copy and distribute verbatim copies of the Program's
  2296.      source code as you receive it, in any medium, provided that you
  2297.      conspicuously and appropriately publish on each copy an appropriate
  2298.      copyright notice and disclaimer of warranty; keep intact all the
  2299.      notices that refer to this License and to the absence of any
  2300.      warranty; and give any other recipients of the Program a copy of
  2301.      this License along with the Program.
  2302.  
  2303.      You may charge a fee for the physical act of transferring a copy,
  2304.      and you may at your option offer warranty protection in exchange
  2305.      for a fee.
  2306.  
  2307.   2. You may modify your copy or copies of the Program or any portion
  2308.      of it, thus forming a work based on the Program, and copy and
  2309.      distribute such modifications or work under the terms of Section 1
  2310.      above, provided that you also meet all of these conditions:
  2311.  
  2312.        a. You must cause the modified files to carry prominent notices
  2313.           stating that you changed the files and the date of any change.
  2314.  
  2315.        b. You must cause any work that you distribute or publish, that
  2316.           in whole or in part contains or is derived from the Program
  2317.           or any part thereof, to be licensed as a whole at no charge
  2318.           to all third parties under the terms of this License.
  2319.  
  2320.        c. If the modified program normally reads commands interactively
  2321.           when run, you must cause it, when started running for such
  2322.           interactive use in the most ordinary way, to print or display
  2323.           an announcement including an appropriate copyright notice and
  2324.           a notice that there is no warranty (or else, saying that you
  2325.           provide a warranty) and that users may redistribute the
  2326.           program under these conditions, and telling the user how to
  2327.           view a copy of this License.  (Exception: if the Program
  2328.           itself is interactive but does not normally print such an
  2329.           announcement, your work based on the Program is not required
  2330.           to print an announcement.)
  2331.  
  2332.      These requirements apply to the modified work as a whole.  If
  2333.      identifiable sections of that work are not derived from the
  2334.      Program, and can be reasonably considered independent and separate
  2335.      works in themselves, then this License, and its terms, do not
  2336.      apply to those sections when you distribute them as separate
  2337.      works.  But when you distribute the same sections as part of a
  2338.      whole which is a work based on the Program, the distribution of
  2339.      the whole must be on the terms of this License, whose permissions
  2340.      for other licensees extend to the entire whole, and thus to each
  2341.      and every part regardless of who wrote it.
  2342.  
  2343.      Thus, it is not the intent of this section to claim rights or
  2344.      contest your rights to work written entirely by you; rather, the
  2345.      intent is to exercise the right to control the distribution of
  2346.      derivative or collective works based on the Program.
  2347.  
  2348.      In addition, mere aggregation of another work not based on the
  2349.      Program with the Program (or with a work based on the Program) on
  2350.      a volume of a storage or distribution medium does not bring the
  2351.      other work under the scope of this License.
  2352.  
  2353.   3. You may copy and distribute the Program (or a work based on it,
  2354.      under Section 2) in object code or executable form under the terms
  2355.      of Sections 1 and 2 above provided that you also do one of the
  2356.      following:
  2357.  
  2358.        a. Accompany it with the complete corresponding machine-readable
  2359.           source code, which must be distributed under the terms of
  2360.           Sections 1 and 2 above on a medium customarily used for
  2361.           software interchange; or,
  2362.  
  2363.        b. Accompany it with a written offer, valid for at least three
  2364.           years, to give any third party, for a charge no more than your
  2365.           cost of physically performing source distribution, a complete
  2366.           machine-readable copy of the corresponding source code, to be
  2367.           distributed under the terms of Sections 1 and 2 above on a
  2368.           medium customarily used for software interchange; or,
  2369.  
  2370.        c. Accompany it with the information you received as to the offer
  2371.           to distribute corresponding source code.  (This alternative is
  2372.           allowed only for noncommercial distribution and only if you
  2373.           received the program in object code or executable form with
  2374.           such an offer, in accord with Subsection b above.)
  2375.  
  2376.      The source code for a work means the preferred form of the work for
  2377.      making modifications to it.  For an executable work, complete
  2378.      source code means all the source code for all modules it contains,
  2379.      plus any associated interface definition files, plus the scripts
  2380.      used to control compilation and installation of the executable.
  2381.      However, as a special exception, the source code distributed need
  2382.      not include anything that is normally distributed (in either
  2383.      source or binary form) with the major components (compiler,
  2384.      kernel, and so on) of the operating system on which the executable
  2385.      runs, unless that component itself accompanies the executable.
  2386.  
  2387.      If distribution of executable or object code is made by offering
  2388.      access to copy from a designated place, then offering equivalent
  2389.      access to copy the source code from the same place counts as
  2390.      distribution of the source code, even though third parties are not
  2391.      compelled to copy the source along with the object code.
  2392.  
  2393.   4. You may not copy, modify, sublicense, or distribute the Program
  2394.      except as expressly provided under this License.  Any attempt
  2395.      otherwise to copy, modify, sublicense or distribute the Program is
  2396.      void, and will automatically terminate your rights under this
  2397.      License.  However, parties who have received copies, or rights,
  2398.      from you under this License will not have their licenses
  2399.      terminated so long as such parties remain in full compliance.
  2400.  
  2401.   5. You are not required to accept this License, since you have not
  2402.      signed it.  However, nothing else grants you permission to modify
  2403.      or distribute the Program or its derivative works.  These actions
  2404.      are prohibited by law if you do not accept this License.
  2405.      Therefore, by modifying or distributing the Program (or any work
  2406.      based on the Program), you indicate your acceptance of this
  2407.      License to do so, and all its terms and conditions for copying,
  2408.      distributing or modifying the Program or works based on it.
  2409.  
  2410.   6. Each time you redistribute the Program (or any work based on the
  2411.      Program), the recipient automatically receives a license from the
  2412.      original licensor to copy, distribute or modify the Program
  2413.      subject to these terms and conditions.  You may not impose any
  2414.      further restrictions on the recipients' exercise of the rights
  2415.      granted herein.  You are not responsible for enforcing compliance
  2416.      by third parties to this License.
  2417.  
  2418.   7. If, as a consequence of a court judgment or allegation of patent
  2419.      infringement or for any other reason (not limited to patent
  2420.      issues), conditions are imposed on you (whether by court order,
  2421.      agreement or otherwise) that contradict the conditions of this
  2422.      License, they do not excuse you from the conditions of this
  2423.      License.  If you cannot distribute so as to satisfy simultaneously
  2424.      your obligations under this License and any other pertinent
  2425.      obligations, then as a consequence you may not distribute the
  2426.      Program at all.  For example, if a patent license would not permit
  2427.      royalty-free redistribution of the Program by all those who
  2428.      receive copies directly or indirectly through you, then the only
  2429.      way you could satisfy both it and this License would be to refrain
  2430.      entirely from distribution of the Program.
  2431.  
  2432.      If any portion of this section is held invalid or unenforceable
  2433.      under any particular circumstance, the balance of the section is
  2434.      intended to apply and the section as a whole is intended to apply
  2435.      in other circumstances.
  2436.  
  2437.      It is not the purpose of this section to induce you to infringe any
  2438.      patents or other property right claims or to contest validity of
  2439.      any such claims; this section has the sole purpose of protecting
  2440.      the integrity of the free software distribution system, which is
  2441.      implemented by public license practices.  Many people have made
  2442.      generous contributions to the wide range of software distributed
  2443.      through that system in reliance on consistent application of that
  2444.      system; it is up to the author/donor to decide if he or she is
  2445.      willing to distribute software through any other system and a
  2446.      licensee cannot impose that choice.
  2447.  
  2448.      This section is intended to make thoroughly clear what is believed
  2449.      to be a consequence of the rest of this License.
  2450.  
  2451.   8. If the distribution and/or use of the Program is restricted in
  2452.      certain countries either by patents or by copyrighted interfaces,
  2453.      the original copyright holder who places the Program under this
  2454.      License may add an explicit geographical distribution limitation
  2455.      excluding those countries, so that distribution is permitted only
  2456.      in or among countries not thus excluded.  In such case, this
  2457.      License incorporates the limitation as if written in the body of
  2458.      this License.
  2459.  
  2460.   9. The Free Software Foundation may publish revised and/or new
  2461.      versions of the General Public License from time to time.  Such
  2462.      new versions will be similar in spirit to the present version, but
  2463.      may differ in detail to address new problems or concerns.
  2464.  
  2465.      Each version is given a distinguishing version number.  If the
  2466.      Program specifies a version number of this License which applies
  2467.      to it and "any later version", you have the option of following
  2468.      the terms and conditions either of that version or of any later
  2469.      version published by the Free Software Foundation.  If the Program
  2470.      does not specify a version number of this License, you may choose
  2471.      any version ever published by the Free Software Foundation.
  2472.  
  2473.  10. If you wish to incorporate parts of the Program into other free
  2474.      programs whose distribution conditions are different, write to the
  2475.      author to ask for permission.  For software which is copyrighted
  2476.      by the Free Software Foundation, write to the Free Software
  2477.      Foundation; we sometimes make exceptions for this.  Our decision
  2478.      will be guided by the two goals of preserving the free status of
  2479.      all derivatives of our free software and of promoting the sharing
  2480.      and reuse of software generally.
  2481.  
  2482.                                 NO WARRANTY
  2483.  
  2484.  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO
  2485.      WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
  2486.      LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  2487.      HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
  2488.      WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT
  2489.      NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
  2490.      FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE
  2491.      QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
  2492.      PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  2493.      SERVICING, REPAIR OR CORRECTION.
  2494.  
  2495.  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
  2496.      WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
  2497.      MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE
  2498.      LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
  2499.      INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
  2500.      INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
  2501.      DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU
  2502.      OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
  2503.      OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
  2504.      ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  2505.  
  2506.                       END OF TERMS AND CONDITIONS
  2507.  
  2508. Appendix: How to Apply These Terms to Your New Programs
  2509. =======================================================
  2510.  
  2511.    If you develop a new program, and you want it to be of the greatest
  2512. possible use to the public, the best way to achieve this is to make it
  2513. free software which everyone can redistribute and change under these
  2514. terms.
  2515.  
  2516.    To do so, attach the following notices to the program.  It is safest
  2517. to attach them to the start of each source file to most effectively
  2518. convey the exclusion of warranty; and each file should have at least
  2519. the "copyright" line and a pointer to where the full notice is found.
  2520.  
  2521.      ONE LINE TO GIVE THE PROGRAM'S NAME AND A BRIEF IDEA OF WHAT IT DOES.
  2522.      Copyright (C) YYYY  NAME OF AUTHOR
  2523.      
  2524.      This program is free software; you can redistribute it and/or modify
  2525.      it under the terms of the GNU General Public License as published by
  2526.      the Free Software Foundation; either version 2 of the License, or
  2527.      (at your option) any later version.
  2528.      
  2529.      This program is distributed in the hope that it will be useful,
  2530.      but WITHOUT ANY WARRANTY; without even the implied warranty of
  2531.      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  2532.      GNU General Public License for more details.
  2533.      
  2534.      You should have received a copy of the GNU General Public License
  2535.      along with this program; if not, write to the Free Software
  2536.      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  2537.  
  2538.    Also add information on how to contact you by electronic and paper
  2539. mail.
  2540.  
  2541.    If the program is interactive, make it output a short notice like
  2542. this when it starts in an interactive mode:
  2543.  
  2544.      Gnomovision version 69, Copyright (C) 19YY NAME OF AUTHOR
  2545.      Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
  2546.      This is free software, and you are welcome to redistribute it
  2547.      under certain conditions; type `show c' for details.
  2548.  
  2549.    The hypothetical commands `show w' and `show c' should show the
  2550. appropriate parts of the General Public License.  Of course, the
  2551. commands you use may be called something other than `show w' and `show
  2552. c'; they could even be mouse-clicks or menu items--whatever suits your
  2553. program.
  2554.  
  2555.    You should also get your employer (if you work as a programmer) or
  2556. your school, if any, to sign a "copyright disclaimer" for the program,
  2557. if necessary.  Here is a sample; alter the names:
  2558.  
  2559.      Yoyodyne, Inc., hereby disclaims all copyright interest in the program
  2560.      `Gnomovision' (which makes passes at compilers) written by James Hacker.
  2561.      
  2562.      SIGNATURE OF TY COON, 1 April 1989
  2563.      Ty Coon, President of Vice
  2564.  
  2565.    This General Public License does not permit incorporating your
  2566. program into proprietary programs.  If your program is a subroutine
  2567. library, you may consider it more useful to permit linking proprietary
  2568. applications with the library.  If this is what you want to do, use the
  2569. GNU Library General Public License instead of this License.
  2570.  
  2571. GNU Free Documentation License
  2572. ******************************
  2573.  
  2574.                         Version 1.1, March 2000
  2575.  
  2576.      Copyright (C) 2000 Free Software Foundation, Inc.
  2577.      59 Temple Place, Suite 330, Boston, MA  02111-1307, USA
  2578.      
  2579.      Everyone is permitted to copy and distribute verbatim copies
  2580.      of this license document, but changing it is not allowed.
  2581.  
  2582.   0. PREAMBLE
  2583.  
  2584.      The purpose of this License is to make a manual, textbook, or other
  2585.      written document "free" in the sense of freedom: to assure everyone
  2586.      the effective freedom to copy and redistribute it, with or without
  2587.      modifying it, either commercially or noncommercially.  Secondarily,
  2588.      this License preserves for the author and publisher a way to get
  2589.      credit for their work, while not being considered responsible for
  2590.      modifications made by others.
  2591.  
  2592.      This License is a kind of "copyleft", which means that derivative
  2593.      works of the document must themselves be free in the same sense.
  2594.      It complements the GNU General Public License, which is a copyleft
  2595.      license designed for free software.
  2596.  
  2597.      We have designed this License in order to use it for manuals for
  2598.      free software, because free software needs free documentation: a
  2599.      free program should come with manuals providing the same freedoms
  2600.      that the software does.  But this License is not limited to
  2601.      software manuals; it can be used for any textual work, regardless
  2602.      of subject matter or whether it is published as a printed book.
  2603.      We recommend this License principally for works whose purpose is
  2604.      instruction or reference.
  2605.  
  2606.   1. APPLICABILITY AND DEFINITIONS
  2607.  
  2608.      This License applies to any manual or other work that contains a
  2609.      notice placed by the copyright holder saying it can be distributed
  2610.      under the terms of this License.  The "Document", below, refers to
  2611.      any such manual or work.  Any member of the public is a licensee,
  2612.      and is addressed as "you".
  2613.  
  2614.      A "Modified Version" of the Document means any work containing the
  2615.      Document or a portion of it, either copied verbatim, or with
  2616.      modifications and/or translated into another language.
  2617.  
  2618.      A "Secondary Section" is a named appendix or a front-matter
  2619.      section of the Document that deals exclusively with the
  2620.      relationship of the publishers or authors of the Document to the
  2621.      Document's overall subject (or to related matters) and contains
  2622.      nothing that could fall directly within that overall subject.
  2623.      (For example, if the Document is in part a textbook of
  2624.      mathematics, a Secondary Section may not explain any mathematics.)
  2625.      The relationship could be a matter of historical connection with
  2626.      the subject or with related matters, or of legal, commercial,
  2627.      philosophical, ethical or political position regarding them.
  2628.  
  2629.      The "Invariant Sections" are certain Secondary Sections whose
  2630.      titles are designated, as being those of Invariant Sections, in
  2631.      the notice that says that the Document is released under this
  2632.      License.
  2633.  
  2634.      The "Cover Texts" are certain short passages of text that are
  2635.      listed, as Front-Cover Texts or Back-Cover Texts, in the notice
  2636.      that says that the Document is released under this License.
  2637.  
  2638.      A "Transparent" copy of the Document means a machine-readable copy,
  2639.      represented in a format whose specification is available to the
  2640.      general public, whose contents can be viewed and edited directly
  2641.      and straightforwardly with generic text editors or (for images
  2642.      composed of pixels) generic paint programs or (for drawings) some
  2643.      widely available drawing editor, and that is suitable for input to
  2644.      text formatters or for automatic translation to a variety of
  2645.      formats suitable for input to text formatters.  A copy made in an
  2646.      otherwise Transparent file format whose markup has been designed
  2647.      to thwart or discourage subsequent modification by readers is not
  2648.      Transparent.  A copy that is not "Transparent" is called "Opaque".
  2649.  
  2650.      Examples of suitable formats for Transparent copies include plain
  2651.      ASCII without markup, Texinfo input format, LaTeX input format,
  2652.      SGML or XML using a publicly available DTD, and
  2653.      standard-conforming simple HTML designed for human modification.
  2654.      Opaque formats include PostScript, PDF, proprietary formats that
  2655.      can be read and edited only by proprietary word processors, SGML
  2656.      or XML for which the DTD and/or processing tools are not generally
  2657.      available, and the machine-generated HTML produced by some word
  2658.      processors for output purposes only.
  2659.  
  2660.      The "Title Page" means, for a printed book, the title page itself,
  2661.      plus such following pages as are needed to hold, legibly, the
  2662.      material this License requires to appear in the title page.  For
  2663.      works in formats which do not have any title page as such, "Title
  2664.      Page" means the text near the most prominent appearance of the
  2665.      work's title, preceding the beginning of the body of the text.
  2666.  
  2667.   2. VERBATIM COPYING
  2668.  
  2669.      You may copy and distribute the Document in any medium, either
  2670.      commercially or noncommercially, provided that this License, the
  2671.      copyright notices, and the license notice saying this License
  2672.      applies to the Document are reproduced in all copies, and that you
  2673.      add no other conditions whatsoever to those of this License.  You
  2674.      may not use technical measures to obstruct or control the reading
  2675.      or further copying of the copies you make or distribute.  However,
  2676.      you may accept compensation in exchange for copies.  If you
  2677.      distribute a large enough number of copies you must also follow
  2678.      the conditions in section 3.
  2679.  
  2680.      You may also lend copies, under the same conditions stated above,
  2681.      and you may publicly display copies.
  2682.  
  2683.   3. COPYING IN QUANTITY
  2684.  
  2685.      If you publish printed copies of the Document numbering more than
  2686.      100, and the Document's license notice requires Cover Texts, you
  2687.      must enclose the copies in covers that carry, clearly and legibly,
  2688.      all these Cover Texts: Front-Cover Texts on the front cover, and
  2689.      Back-Cover Texts on the back cover.  Both covers must also clearly
  2690.      and legibly identify you as the publisher of these copies.  The
  2691.      front cover must present the full title with all words of the
  2692.      title equally prominent and visible.  You may add other material
  2693.      on the covers in addition.  Copying with changes limited to the
  2694.      covers, as long as they preserve the title of the Document and
  2695.      satisfy these conditions, can be treated as verbatim copying in
  2696.      other respects.
  2697.  
  2698.      If the required texts for either cover are too voluminous to fit
  2699.      legibly, you should put the first ones listed (as many as fit
  2700.      reasonably) on the actual cover, and continue the rest onto
  2701.      adjacent pages.
  2702.  
  2703.      If you publish or distribute Opaque copies of the Document
  2704.      numbering more than 100, you must either include a
  2705.      machine-readable Transparent copy along with each Opaque copy, or
  2706.      state in or with each Opaque copy a publicly-accessible
  2707.      computer-network location containing a complete Transparent copy
  2708.      of the Document, free of added material, which the general
  2709.      network-using public has access to download anonymously at no
  2710.      charge using public-standard network protocols.  If you use the
  2711.      latter option, you must take reasonably prudent steps, when you
  2712.      begin distribution of Opaque copies in quantity, to ensure that
  2713.      this Transparent copy will remain thus accessible at the stated
  2714.      location until at least one year after the last time you
  2715.      distribute an Opaque copy (directly or through your agents or
  2716.      retailers) of that edition to the public.
  2717.  
  2718.      It is requested, but not required, that you contact the authors of
  2719.      the Document well before redistributing any large number of
  2720.      copies, to give them a chance to provide you with an updated
  2721.      version of the Document.
  2722.  
  2723.   4. MODIFICATIONS
  2724.  
  2725.      You may copy and distribute a Modified Version of the Document
  2726.      under the conditions of sections 2 and 3 above, provided that you
  2727.      release the Modified Version under precisely this License, with
  2728.      the Modified Version filling the role of the Document, thus
  2729.      licensing distribution and modification of the Modified Version to
  2730.      whoever possesses a copy of it.  In addition, you must do these
  2731.      things in the Modified Version:
  2732.  
  2733.        A. Use in the Title Page (and on the covers, if any) a title
  2734.           distinct from that of the Document, and from those of
  2735.           previous versions (which should, if there were any, be listed
  2736.           in the History section of the Document).  You may use the
  2737.           same title as a previous version if the original publisher of
  2738.           that version gives permission.
  2739.  
  2740.        B. List on the Title Page, as authors, one or more persons or
  2741.           entities responsible for authorship of the modifications in
  2742.           the Modified Version, together with at least five of the
  2743.           principal authors of the Document (all of its principal
  2744.           authors, if it has less than five).
  2745.  
  2746.        C. State on the Title page the name of the publisher of the
  2747.           Modified Version, as the publisher.
  2748.  
  2749.        D. Preserve all the copyright notices of the Document.
  2750.  
  2751.        E. Add an appropriate copyright notice for your modifications
  2752.           adjacent to the other copyright notices.
  2753.  
  2754.        F. Include, immediately after the copyright notices, a license
  2755.           notice giving the public permission to use the Modified
  2756.           Version under the terms of this License, in the form shown in
  2757.           the Addendum below.
  2758.  
  2759.        G. Preserve in that license notice the full lists of Invariant
  2760.           Sections and required Cover Texts given in the Document's
  2761.           license notice.
  2762.  
  2763.        H. Include an unaltered copy of this License.
  2764.  
  2765.        I. Preserve the section entitled "History", and its title, and
  2766.           add to it an item stating at least the title, year, new
  2767.           authors, and publisher of the Modified Version as given on
  2768.           the Title Page.  If there is no section entitled "History" in
  2769.           the Document, create one stating the title, year, authors,
  2770.           and publisher of the Document as given on its Title Page,
  2771.           then add an item describing the Modified Version as stated in
  2772.           the previous sentence.
  2773.  
  2774.        J. Preserve the network location, if any, given in the Document
  2775.           for public access to a Transparent copy of the Document, and
  2776.           likewise the network locations given in the Document for
  2777.           previous versions it was based on.  These may be placed in
  2778.           the "History" section.  You may omit a network location for a
  2779.           work that was published at least four years before the
  2780.           Document itself, or if the original publisher of the version
  2781.           it refers to gives permission.
  2782.  
  2783.        K. In any section entitled "Acknowledgments" or "Dedications",
  2784.           preserve the section's title, and preserve in the section all
  2785.           the substance and tone of each of the contributor
  2786.           acknowledgments and/or dedications given therein.
  2787.  
  2788.        L. Preserve all the Invariant Sections of the Document,
  2789.           unaltered in their text and in their titles.  Section numbers
  2790.           or the equivalent are not considered part of the section
  2791.           titles.
  2792.  
  2793.        M. Delete any section entitled "Endorsements".  Such a section
  2794.           may not be included in the Modified Version.
  2795.  
  2796.        N. Do not retitle any existing section as "Endorsements" or to
  2797.           conflict in title with any Invariant Section.
  2798.  
  2799.      If the Modified Version includes new front-matter sections or
  2800.      appendices that qualify as Secondary Sections and contain no
  2801.      material copied from the Document, you may at your option
  2802.      designate some or all of these sections as invariant.  To do this,
  2803.      add their titles to the list of Invariant Sections in the Modified
  2804.      Version's license notice.  These titles must be distinct from any
  2805.      other section titles.
  2806.  
  2807.      You may add a section entitled "Endorsements", provided it contains
  2808.      nothing but endorsements of your Modified Version by various
  2809.      parties--for example, statements of peer review or that the text
  2810.      has been approved by an organization as the authoritative
  2811.      definition of a standard.
  2812.  
  2813.      You may add a passage of up to five words as a Front-Cover Text,
  2814.      and a passage of up to 25 words as a Back-Cover Text, to the end
  2815.      of the list of Cover Texts in the Modified Version.  Only one
  2816.      passage of Front-Cover Text and one of Back-Cover Text may be
  2817.      added by (or through arrangements made by) any one entity.  If the
  2818.      Document already includes a cover text for the same cover,
  2819.      previously added by you or by arrangement made by the same entity
  2820.      you are acting on behalf of, you may not add another; but you may
  2821.      replace the old one, on explicit permission from the previous
  2822.      publisher that added the old one.
  2823.  
  2824.      The author(s) and publisher(s) of the Document do not by this
  2825.      License give permission to use their names for publicity for or to
  2826.      assert or imply endorsement of any Modified Version.
  2827.  
  2828.   5. COMBINING DOCUMENTS
  2829.  
  2830.      You may combine the Document with other documents released under
  2831.      this License, under the terms defined in section 4 above for
  2832.      modified versions, provided that you include in the combination
  2833.      all of the Invariant Sections of all of the original documents,
  2834.      unmodified, and list them all as Invariant Sections of your
  2835.      combined work in its license notice.
  2836.  
  2837.      The combined work need only contain one copy of this License, and
  2838.      multiple identical Invariant Sections may be replaced with a single
  2839.      copy.  If there are multiple Invariant Sections with the same name
  2840.      but different contents, make the title of each such section unique
  2841.      by adding at the end of it, in parentheses, the name of the
  2842.      original author or publisher of that section if known, or else a
  2843.      unique number.  Make the same adjustment to the section titles in
  2844.      the list of Invariant Sections in the license notice of the
  2845.      combined work.
  2846.  
  2847.      In the combination, you must combine any sections entitled
  2848.      "History" in the various original documents, forming one section
  2849.      entitled "History"; likewise combine any sections entitled
  2850.      "Acknowledgments", and any sections entitled "Dedications".  You
  2851.      must delete all sections entitled "Endorsements."
  2852.  
  2853.   6. COLLECTIONS OF DOCUMENTS
  2854.  
  2855.      You may make a collection consisting of the Document and other
  2856.      documents released under this License, and replace the individual
  2857.      copies of this License in the various documents with a single copy
  2858.      that is included in the collection, provided that you follow the
  2859.      rules of this License for verbatim copying of each of the
  2860.      documents in all other respects.
  2861.  
  2862.      You may extract a single document from such a collection, and
  2863.      distribute it individually under this License, provided you insert
  2864.      a copy of this License into the extracted document, and follow
  2865.      this License in all other respects regarding verbatim copying of
  2866.      that document.
  2867.  
  2868.   7. AGGREGATION WITH INDEPENDENT WORKS
  2869.  
  2870.      A compilation of the Document or its derivatives with other
  2871.      separate and independent documents or works, in or on a volume of
  2872.      a storage or distribution medium, does not as a whole count as a
  2873.      Modified Version of the Document, provided no compilation
  2874.      copyright is claimed for the compilation.  Such a compilation is
  2875.      called an "aggregate", and this License does not apply to the
  2876.      other self-contained works thus compiled with the Document, on
  2877.      account of their being thus compiled, if they are not themselves
  2878.      derivative works of the Document.
  2879.  
  2880.      If the Cover Text requirement of section 3 is applicable to these
  2881.      copies of the Document, then if the Document is less than one
  2882.      quarter of the entire aggregate, the Document's Cover Texts may be
  2883.      placed on covers that surround only the Document within the
  2884.      aggregate.  Otherwise they must appear on covers around the whole
  2885.      aggregate.
  2886.  
  2887.   8. TRANSLATION
  2888.  
  2889.      Translation is considered a kind of modification, so you may
  2890.      distribute translations of the Document under the terms of section
  2891.      4.  Replacing Invariant Sections with translations requires special
  2892.      permission from their copyright holders, but you may include
  2893.      translations of some or all Invariant Sections in addition to the
  2894.      original versions of these Invariant Sections.  You may include a
  2895.      translation of this License provided that you also include the
  2896.      original English version of this License.  In case of a
  2897.      disagreement between the translation and the original English
  2898.      version of this License, the original English version will prevail.
  2899.  
  2900.   9. TERMINATION
  2901.  
  2902.      You may not copy, modify, sublicense, or distribute the Document
  2903.      except as expressly provided for under this License.  Any other
  2904.      attempt to copy, modify, sublicense or distribute the Document is
  2905.      void, and will automatically terminate your rights under this
  2906.      License.  However, parties who have received copies, or rights,
  2907.      from you under this License will not have their licenses
  2908.      terminated so long as such parties remain in full compliance.
  2909.  
  2910.  10. FUTURE REVISIONS OF THIS LICENSE
  2911.  
  2912.      The Free Software Foundation may publish new, revised versions of
  2913.      the GNU Free Documentation License from time to time.  Such new
  2914.      versions will be similar in spirit to the present version, but may
  2915.      differ in detail to address new problems or concerns.  See
  2916.      `http://www.gnu.org/copyleft/'.
  2917.  
  2918.      Each version of the License is given a distinguishing version
  2919.      number.  If the Document specifies that a particular numbered
  2920.      version of this License "or any later version" applies to it, you
  2921.      have the option of following the terms and conditions either of
  2922.      that specified version or of any later version that has been
  2923.      published (not as a draft) by the Free Software Foundation.  If
  2924.      the Document does not specify a version number of this License,
  2925.      you may choose any version ever published (not as a draft) by the
  2926.      Free Software Foundation.
  2927.  
  2928. ADDENDUM: How to use this License for your documents
  2929. ====================================================
  2930.  
  2931.    To use this License in a document you have written, include a copy of
  2932. the License in the document and put the following copyright and license
  2933. notices just after the title page:
  2934.  
  2935.        Copyright (C)  YEAR  YOUR NAME.
  2936.        Permission is granted to copy, distribute and/or modify this document
  2937.        under the terms of the GNU Free Documentation License, Version 1.1
  2938.        or any later version published by the Free Software Foundation;
  2939.        with the Invariant Sections being LIST THEIR TITLES, with the
  2940.        Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
  2941.        A copy of the license is included in the section entitled ``GNU
  2942.        Free Documentation License''.
  2943.  
  2944.    If you have no Invariant Sections, write "with no Invariant Sections"
  2945. instead of saying which ones are invariant.  If you have no Front-Cover
  2946. Texts, write "no Front-Cover Texts" instead of "Front-Cover Texts being
  2947. LIST"; likewise for Back-Cover Texts.
  2948.  
  2949.    If your document contains nontrivial examples of program code, we
  2950. recommend releasing these examples in parallel under your choice of
  2951. free software license, such as the GNU General Public License, to
  2952. permit their use in free software.
  2953.  
  2954. XML Tag Index
  2955. *************
  2956.  
  2957. album-id:
  2958.           See ```<info>' Container''.
  2959. application-id:
  2960.           See ```<pvd>' Container''.
  2961. auto-pause:
  2962.           See ```<sequence-item>' Element''.
  2963. autowait:
  2964.           See ```<playlist>' Element''.
  2965. bsn:
  2966.           See ```<selection>' Element''.
  2967. default:
  2968.           See ```<selection>' Element''.
  2969. default-entry:
  2970.           See ```<sequence-item>' Element''.
  2971. endlist:
  2972.           See ```<endlist>' Element''.
  2973. entry:
  2974.           See ```<sequence-item>' Element''.
  2975. file:
  2976.           See ```<file>' Element''.
  2977. filesystem:
  2978.           See ```<filesystem>' Container''.
  2979. folder:
  2980.           See ```<folder>' Element/Container''.
  2981. FORMAT:
  2982.           See ```<file>' Element''.
  2983. info:
  2984.           See ```<info>' Container''.
  2985. JUMP-TIMING:
  2986.           See ```<selection>' Element''.
  2987. loop:
  2988.           See ```<selection>' Element''.
  2989. multi-default:
  2990.           See ```<selection>' Element''.
  2991. name <1>:
  2992.           See ```<folder>' Element/Container''.
  2993. name:
  2994.           See ```<file>' Element''.
  2995. next <1>:
  2996.           See ```<playlist>' Element''.
  2997. next:
  2998.           See ```<selection>' Element''.
  2999. next-volume:
  3000.           See ```<endlist>' Element''.
  3001. next-volume-use-lid2:
  3002.           See ```<info>' Container''.
  3003. next-volume-use-sequence2:
  3004.           See ```<info>' Container''.
  3005. NUMERIC:
  3006.           See ```<selection>' Element''.
  3007. option:
  3008.           See ```<option>' Element''.
  3009. pbc:
  3010.           See ```<pbc>' Container''.
  3011. play-item <1>:
  3012.           See ```<selection>' Element''.
  3013. play-item <2>:
  3014.           See ```<playlist>' Element''.
  3015. play-item <3>:
  3016.           See ```<endlist>' Element''.
  3017. play-item:
  3018.           See ```<pbc>' Container''.
  3019. playlist:
  3020.           See ```<playlist>' Element''.
  3021. playtime:
  3022.           See ```<playlist>' Element''.
  3023. preparer-id:
  3024.           See ```<pvd>' Container''.
  3025. prev <1>:
  3026.           See ```<selection>' Element''.
  3027. prev:
  3028.           See ```<playlist>' Element''.
  3029. publisher-id:
  3030.           See ```<pvd>' Container''.
  3031. pvd:
  3032.           See ```<pvd>' Container''.
  3033. REJECTED:
  3034.           See ```<pbc>' Container''.
  3035. restriction:
  3036.           See ```<info>' Container''.
  3037. return <1>:
  3038.           See ```<playlist>' Element''.
  3039. return:
  3040.           See ```<selection>' Element''.
  3041. segment-item:
  3042.           See ```<segment-item>' Element''.
  3043. segment-items:
  3044.           See ```<segment-items>' Container''.
  3045. select:
  3046.           See ```<selection>' Element''.
  3047. selection:
  3048.           See ```<selection>' Element''.
  3049. sequence-item:
  3050.           See ```<sequence-item>' Element''.
  3051. sequence-items:
  3052.           See ```<sequence-items>' Container''.
  3053. SRC:
  3054.           See ```<file>' Element''.
  3055. start-time-offset:
  3056.           See ```<info>' Container''.
  3057. system-id:
  3058.           See ```<pvd>' Container''.
  3059. timeout:
  3060.           See ```<selection>' Element''.
  3061. videocd:
  3062.           See ```<videocd>' Root''.
  3063. volume-count:
  3064.           See ```<info>' Container''.
  3065. volume-id:
  3066.           See ```<pvd>' Container''.
  3067. volume-number:
  3068.           See ```<info>' Container''.
  3069. wait <1>:
  3070.           See ```<playlist>' Element''.
  3071. wait:
  3072.           See ```<selection>' Element''.
  3073. X1:
  3074.           See ```<pbc>' Container''.
  3075. X2:
  3076.           See ```<pbc>' Container''.
  3077. Y1:
  3078.           See ```<pbc>' Container''.
  3079. Y2:
  3080.           See ```<pbc>' Container''.
  3081. Concept Index
  3082. *************
  3083.  
  3084. cdrdao, How to use:
  3085.           See ``Examples''.
  3086. Chapters:
  3087.           See ``Linear Playback''.
  3088. DTD of Video CD XML:
  3089.           See ``Video CD XML Description''.
  3090. Entry points:
  3091.           See ```<sequence-item>' Element''.
  3092. FDL, GNU Free Documentation License:
  3093.           See ``GNU Free Documentation License''.
  3094. GPL, GNU General Public License:
  3095.           See ``GNU General Public License''.
  3096. Hot spot area coordinates:
  3097.           See ```<pbc>' Container''.
  3098. HQ Video CD 1.0:
  3099.           See ``HQ Video CD 1.0''.
  3100. HQ-VCD:
  3101.           See ``HQ Video CD 1.0''.
  3102. Interactivity, Video CD support for:
  3103.           See ``Playback Control''.
  3104. ISO-9660 filename constraints:
  3105.           See ``Adding Files to the Video CD''.
  3106. Keys, on the remote control:
  3107.           See ``Function Keys for Interaction''.
  3108. Menu highlighting:
  3109.           See ``Selection List''.
  3110. Menu selection areas:
  3111.           See ``Selection List''.
  3112. Menus <1>:
  3113.           See ``Selection List''.
  3114. Menus:
  3115.           See ```<selection>' Element''.
  3116. MPEG Access point sector:
  3117.           See ``Access Point Sectors''.
  3118. MPEG input streams:
  3119.           See ``Constraints on MPEG streams''.
  3120. MPEG padding:
  3121.           See ``Alignment''.
  3122. MPEG scan information user data:
  3123.           See ``Scan Information Data''.
  3124. PBC (Playback control):
  3125.           See ``Playback Control''.
  3126. Play nothing item <1>:
  3127.           See ```<pbc>' Container''.
  3128. Play nothing item:
  3129.           See ``XML Simplified Rules''.
  3130. Random selection on timeout:
  3131.           See ```<selection>' Element''.
  3132. Rejected list:
  3133.           See ```<pbc>' Container''.
  3134. Relaxed APS constraints:
  3135.           See ```<option>' Element''.
  3136. RIFF CDXA files:
  3137.           See ``Supplied Tools''.
  3138. SPI area <1>:
  3139.           See ``Anatomy of Video CD's''.
  3140. SPI area:
  3141.           See ``Segment Items''.
  3142. Subtitles:
  3143.           See ``SVCD Subtitles''.
  3144. update scan offsets:
  3145.           See ```<option>' Element''.
  3146. Video CD file-system:
  3147.           See ``Directory Structure''.
  3148. Video CD layout:
  3149.           See ``Anatomy of Video CD's''.
  3150. Video CD variants:
  3151.           See ``Known Video CD Flavors''.
  3152. XML Identifiers:
  3153.           See ``XML Simplified Rules''.
  3154. XML, time values in:
  3155.           See ``XML Simplified Rules''.
  3156.